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Preface 


This manual deals with the interaction between the user and the RSTS-11 terminal, how to 


enter and edit user programs, and how to give commands to BASIC-PLUS. 


The operations of listing, running, saving, or compiling a program differ in kind from 
the individual statements composing the program. System commands cause these operations to 
be performed. Other system operations include assigning of peripheral devices for program 
input and/or output, determining the length of the current program or number of user files 
available, renaming and replacing of current files, and enabling and disabling of the echo 


feature on the RSTS-11 terminal. 
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SOFTWARE SUPPORT CATEGORIES 


Digital Equipment Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 

The four categories are as follows: 


CATEGORY | 
Software Products Supported at no Charge 


This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category | to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party. 


CATEGORY Il 
Software Products that Receive Support for a Fee 


This category includes prior versions of Category | programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in, con- 
junction with these DEC programs and equipment supplied by DEC. 


CATEGORY III 
Pre-Release Software 


DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 


CATEGORY IV 
Non-Supported Software 


This category includes all programs for which no support is given 
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CHAPTER 1 


INTRODUCTION TO RSTS-11 


RSTS~11 (Resource Sharing Timesharing System for the PDP-1] computer) is a powerful 
timesharing system that can support up to 16 interactive terminals. From each terminal a user 


has access to any peripheral device on the system. 


RSTS-11 uses the BASIC-PLUS language, an enriched version of the BASIC language as 
originally developed at Dartmouth College. BASIC-PLUS is compatible with existing BASIC 


programs and includes facilities to handle strings, matrices, and files. 


1.1) TIMESHARING 


Early computers were the province of the mathematician. Used mainly to solve differen- 
tial equations, the systems were narrow in scope and poorly utilized. Since few persons were 
knowledgeable enough to employ the enormous processors, one individual could monopolize 


computer time -- sit at the console and solve problems in step-by-step fashion. 


As more people discovered comput ing techniques, it was no longer practical to let a few 
persons monopolize computer time. To increase machine efficiency, batch processing was 
introduced. In this mode of operation, no time was wasted between jobs. Programs were 
punched on cards and the cards stacked and fed to the computer in batches. Operation of each 


program was governed by control cards that took the place of the human operator. 


Since card reading is a relatively slow process, some early systems employed a small 
computer to read the cards and transfer program information to magnetic tape that was then 
input to the large computer. As a further refinement, programs were assigned priorities, with 


short jobs being executed first to minimize job turnaround. 


But what about the computer user? As computer utilization improved, program develop- 
ment took more time. To develop a new program, a user performed the following procedure. 
After writing the program on paper, he carried it to a keypunch operator to have the cards 
punched and verified. A day or so later, when the program was returned, the user checked 


for punching errors, then returned to the keypunch for corrections. 


Next, he sent the cards to the computer center for compilation. The compilation, which 
might not be returned for a half day or more, could reveal spelling or syntactical errors. The 


cards then had to be changed and resubmitted -- another half day's wait. If the next 
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compilation was successful and the program was run, program logic errors might be discovered -- new 
cards, new compilation, etc., etc. In addition, the user often studied reams of computer 
listings to find the errors. Using these inefficient methods, even simple programs might take 


weeks to develop. 


Batch processing maximizes machine efficiency in routine data processing operations where 
turnaround is not critical. But for program development and modification, the user requires 
another mode of operation. The user needs a way to "interact" with the computer ~~ to feed 


his program to the system, line by line, and continuously check the results. 


In fact, the user may want to develop interactive programs. These programs, which are 


extremely productive tools, ask the user questions and perform an analysis based on his answers. 


If the user had unlimited funds, he might be tempted to buy or lease a large computer -- a 
system he could dedicate to his work that would provide sufficient power, many peripherals, and 
a large variety of software. With such a system, the user could develop programs interactively 
or utilize batch processing for routine tasks. | However, costs normally preclude the dedication 


of a large system to a single user. 


By using timesharing, the user has most of the benefits of a dedicated system at a small 
fraction of the cost. Timesharing with today's technology allows a large powerful computer 
such as a PDP-10 to handle 20, 50, 100 or more users simultaneously. Through a choice of 
terminals, the user can interact with the system or initiate batch processing which runs con- 
currently. The user also has access to a choice of mass storage and peripherals and a selection 
of languages and application programs. Since response is fast, the user appears to have a 
dedicated system. Yet costs are shared. He pays only for the time and facilities that he 


requires and doesn't pay for the time the machine is idle. 


A timesharing system isn't just any computer with some additional hardware and software. 
It's a system designed specifically for timesharing. Otherwise, facilities are limited, fewer 


users can be handled efficiently, and economics are unattractive. 


In a simple timesharing system, each program is assigned a fixed time slice or time 
quantum and operation is switched from one program to another in round robin fashion until 
each program is completed. Essentially, if each user receives 1/60 of a second and 12 users 


are "on" the system, each user will receive service every 1/5 of a second. 


The timesharing system performs multiprogramming; that is, it allows several programs to 
reside in core simultaneously and to operate sequentially. The switching between programs is 


initiated by a clock which interrupts the central processor to signal that a certain time period 
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has elapsed. A monitor, also called an operating system or executive program, directs the 


execution of these tasks and performs other duties. 


The system discussed so far services a number of users sequentially in round robin fashion. 
To increase the number of users serviced, more main memory or core is required. However, since 
core is expensive, a secondary memory is employed. This memory -- usually magnetic disk or 
drum -- is slower than core or main memory but provides greatly increased capacity at reasonable 
cost. User programs can be located in secondary memory and moved into main memory for 
execution. Programs entering main memory exchange places with a program (or programs) that 


has just been serviced by the central processor. This operation is called swapping. 


In operation, main memory is divided into separate memory blocks. Secondary memory 
is connected to these blocks through a high speed input/output processor -- a hardware device 
that allows the disk or drum to swap a program into any one of the main memory blocks without 
any aid from the central processor. This structure allows the central processor to be operating 
@ user program in one block of memory while programs are being swapped to and from another 
block. This independent overlapped operation greatly improves efficiency and processing 


power. 


Round robin scheduling, in which each program operates in sequence and receives a fixed 
amount of time, is effective only if all programs have similar requirements. Such is not the 
case, however. At any particular time, a timesharing system will be handling some programs 
which require extensive amounts of computing time (and are said to be compute bound) and 


other programs that must stop frequently for input or output (I/O bound). 


To serve programs at and between these two extremes, the scheduling algorithm must 
provide frequent service to I/O bound programs and must give compute bound jobs longer time 
quantums to prevent wasteful swapping. A simple dynamic scheme could provide two 
queues ~- one for each type of job. When a user first logs on to the system, he is placed in 
an 1/O bound queve (waiting line) where he receives frequent service and small time quantums. 
If the program isn't completed or does not request input or output during the time allotted to 
him, the job needs more computing time and is placed in the compute bound queue. Thus the 
scheduling algorithm optimizes system efficiency by automatically adjusting to program 


requirements. 


In the present state of scheduling art, algorithms are constantly being changed and im- 
proved. Current algorithms are extremely sophisticated, providing excellent service for most 


timesharing job mixes. They also allow fine tuning, if such modifications are necessary. 


The ability of the algorithm to match processing to program requirements ensures the best service 


possible for all user programs. 


A timesharing system has performed its basic function if it allows a number of users 
simultaneous access to a central computer. However, to be fully useful, the system should 
also allow the users access to other system resources ~~ storage devices for his programs and data, 
line printers, card readers, etc. For example, the user should be able to choose between 
magnetic tape and disk for program storage. And if he has a 50-page report to produce, he 
should be able to employ a line printer instead of his Teletype. if users controlled these 
devices, however, much confusion might result. For example, two users might select the line 
printer at the same time. If one user was processing Abraham Lincoln's Gettysburgh Address 


and another Mark Anthony's funeral oration, the report might look like the following: 


| COME TO BURY CAESAR NOT TO PRAISE HIM 

FOUR SCORE AND SEVEN YEARS AGO 

THE EVIL THAT MEN DO LIVE AFTER THEM 

OUR FATHERS BROUGHT FORTH ON THIS CONTINENT 


To prevent users from interfering with each other, the monitor coordinates input and output 


(I/O). 


The user can request that a particular device be assigned for his use, and release the 
device upon completion of an operation. During this time no other user can perform I/O to 
an assigned device. If the user does not specifically assign a device but attempts to use it, 
he is given access to the device if it is not already assigned to another user or currently being 


used. 


If a user does not require a fast device for his exclusive use (like a private disk), he can 
elect to use a public device, such as the public disk area, line printer, paper tape devices, 


etc. 


User programs and data can coexist on the same storage device. A filing system is 


necessary if program and data segments are to be retrieved in proper order. 


Data is transferred from memory to a peripheral device as a block of words or a record. 
(A word is the number of binary digits or bits that the central processor can retrieve and 
"operate on" at one time.) Record length can be arbitrary or dictated by the physical device 
being used, for example, the number of columns on an 80 column card or on a 132 column line 
printer. For PDP-11 disk files, the normal length is 256 words. This can be altered with 
the RSTS-11 Record I/O features. 


iTeletvpe is a registered trademark of the Teletype Corporation. 
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For convenience each user's blocks are organized in groups called files. Files, like 
memory, must be protected from access by unauthorized users. When a user creates a file, he 
can restrict it, specifying whether others can have access, and (if access is permitted) whether 
the files can be modified or only read. With such an arrangement, programmers in various 
locations can use the same data to work simultaneously on the same project; but unauthorized 


personnel cannot modify or read the files. 


Users can communicate with the computer over the conventional dial-up telephone net- 
work, User terminals can, therefore, be located anywhere that phone service is available and 


be connected to any computer system, feasibility limited only by long distance phone rates. 


Each user terminal is connected to a data set or modem (modulator-demodulator) which 
converts user terminal output into a signal suitable for the telephone network. At the computer 
end of the phone lines, there is another data set which reconverts the signal and feeds it to the 


central processor. 


The number of data sets employed at the user end of the system is unlimited. At the 
computer end of the communications network, however, the number of data sets is limited by 


the number of users that can be serviced simultaneously by the system. 


In order to gain access to the system, the user dials the system phone number from his 
data set. The telephone network handles the call, scanning the data sets at the computer 
system. If all of the sets are busy, the user receives a busy signal, just as he would with 
normal phone service. If a set is available, the telephone network rings it, and the computer 
answers the call, placing the user in communication with the monitor. The terminal is then 


on-line and ready for operation. 


1.2. USING RSTS-11 


The remainder of this document describes how to use the RSTS-11 system from the user 
terminal. The user may issue commands to the RSTS-11 monitor (Chapter 2) or use any of the 
system programs available in the system library (Chapter 4). Chapter 5 describes the manual 
operation of typical RSTS-11 peripheral devices. 


For information on the BASIC-PLUS language, the user is referred to the BASIC-PLUS 
Language Manual. The appendices to this document summarize the language elements as 


well as other information such as commands and error messages. 


1-5 


CHAPTER 2 
RSTS-11 SYSTEM COMMANDS 


2.1 ON-LINE WITH RSTS-11 
2.1.1 Project-Programmer Numbers and Passwords 


Before the user attempts to use the RSTS-11 system, the system manager will assign him a 
unique project-programmer number and password. The project-programmer number might, for 


example, look as follows: 


[igs , 161] 


The number 19% above is the project number (possibly held by a group of people having a common 
interest) ; and the number 191 is the programmer number (held by only one person within the 
project group). Thus, each individual's project-programmer number is different. The project- 
programmer number is also called the user's account number. Protection codes are assigned to 
user files on the basis of the various relationships among users as determined by the components 


of their account numbers (see section 2.4.3 describing the NAME-AS statement). 


The user password is a unique alphanumeric code assigned to an individual user. This 
password is never printed on the terminal and, hence, allows for a measure of security in limiting 


the use of the computer system. 
2.1.2 Getting On-Line, HELLO Command 


Equipped with the codes to obtain access to the system, the user should find a terminal and 
turn the LINE-OFF-LOCAL knob ! to LINE. This puts the Teletype terminal on-line to RSTS-11, 


that is, opens a line of communication between the computer and the terminal. 
Once the terminal is on-line, type the command: 
HELLO 


followed by the RETURN key. This tells RSTS-11 that a user wishes to join the system. RSTS-11 
responds by printing a system identification message, then prints a number sign (#) at the left 
margin of the paper, and then waits for the user to type his project-programmer number (followed 


by the RETURN key). The system responds by printing: 
PASSWORD: 


and then waits for the user to type his password followed by the RETURN key. The password 


'This knob is found on ASR-33 and ASR-35 Teletypes. Alternate types of user terminals may have 
a different knob or switch designed to put the device on-line. 
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characters are not printed at the console. If the codes are acceptable to the system, the user 
is logged into the system. A message specified by the system manager is then printed. This 
message generally changes from day to day and provides the user with information on any changes 


or additions to the system. 
If the codes entered are incorrect, the message 
INVALID ENTRY - TRY AGAIN 
is printed and the user can try again. 


The entire process of entering the system is shown below (although the RETURN key is typed 
to enter a line to the system, it does not echo on the terminal paper except to perform a carriage 
return/line feed operation). Characters printed by the system are underlined to differentiate 


them from characters typed by the user. 


KELSO 
reTo YbO~+)) 
fi Wiis G1 
PASSUVOGEIS 


Sr1Siky Pls 


JOP | Ke P5-A0C- 7) eek AY 


VEL COME TO BEis-11 } 

LEMO PEOCEOMS GON THIS SYS1RY AF? 
eoEN CG) -- UOFLER EVIbY AND INUFNIOFY CONTROL. 
TERVOP -- FPAYHGLL AVE CHRECK-FRINTING. 


Once successfully logged onto the system, the user can type NEW to create a new program, OLD 


to retrieve a program previously saved, or any other RSTS-11 command. 


An alternate way of logging into the system is to enter the project-programmer numbers on 
the same line with the HELLO command, as shown below. This results in the system prompting 


the typing of the password only. 


HELLO 14%, 142 

BSTS VAA-11 SYSTFM #213 JOP 1 KPE 15-Al-72 12:29 4% 
PASSE GED? 

WELCOME TO FSTS<11 1 

DEYG PROGKAYS OV THIS SYSTFY ANE: 


FDEMGL -- OFDFER FNTPY AND INVENTORY CONTFOL. 
FLEMOR == PAYPOLL ANT CHECK-PEIN TING. 


NFU OF OLbe< 


Another option available when logging into the system is the use of the slash character 
rather than the comma to separate the project and programmer numbers. The slash character 
inhibits the opening message (s) printed by the system. Such messages are installed on the system 
by the system manager and generally contain useful information. However, when logging into 
the same system several times in one day, it is frequently desirable to eliminate the time neces- 


sary to print a message the user has seen previously. 


HFLLO 


FSTS V4A-11 SYSTFM #213 JOR 1 KRE 15-AfIG-72 12:40 am 
#19A/ 190 
PASSWORN: 


NFY OF OLEI-- 


2.1.3 Going Off-Line, BYE Command 


When the user is ready to leave the terminal, he types the command: 
BYE 


followed by the RETURN key. This tells RSTS-11 that the user has requested to be dismissed 
from the system. At this point RSTS-11 prints 


CONFIRM: 


and waits for the user to give one of the following replies: 


2-3 


CONFIRM: 


Reply Meaning 
N No. The logout sequence is terminated, the user is not 


logged out, and the system again replies NEW OR OLD-- 


I Individual. The user wishes to individually examine each 
of his files. The system prints a listing of each user file 
on the system disk, its size, protection code and creation 
date, followed by a ? character. The user can reply by 
typing K to kill (delete) the file or type the RETURN 
key to retain the file. (Any reply other than K causes 
the file to be retained.) 


RETURN Key Causes the system to print a message explaining that typing 
a ? character explains acceptable replies. 


? Causes the system to print an explanation of the possible 


CONFIRM: replies. 


Y Yes. The system attempts to proceed with the logout se- 
quence, checking to see that the user has not exceeded the 
disk quota for his project-programmer number. If the user 
has used more than his share of disk storage, an appropriate 
message is printed and he is not allowed to leave the system 
until he is within his disk quota. 


The following is the simplest case in which the user simply logs out of the system. 


PYE 

CONFIFM: ¥ 

SAVED ALL DISK FILFSs 3267 FLOCKS IN UiSFs 112 FREER 

JOR 1 SFR 160.1491 LOGCFD OFF KPP AL 15-AUG-72 1°28 aM 
SYSTFM FSTE V4A-11 SYS1RY #212 

RON TIMF VAS «7 SFCONDS 

FLAPSFD TIME WAS 45 SFCONDS 

GOOD MOFNING 


The following example demonstrates the ? and N replies: 


RYF 
CONFIRM: ? 
OPTIONS FOR "CONFIRMS * ARs 


z THIS HELP MESSACE 
N DON'T LOG ME OUT 
I INDIVIDUAL FILF DELETION 


K TO DELETE 

<CKH> TO SAVE 
OTHER LOG MF OUT 
CONFIRM: N 


NEW OF OLTDe- 
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The following example shows the sequence in which the user is over his disk quota; deletes 


some files, and then logs out of the system: 


RYE 

CONFIF™M: Y 

DISK QUOTA OF 540 EXCEEKLED Py 64 BLOCKS 

SOMF FILFCS) MUST RE DELEIFD RERORF LOGGING ONT 
CONFIRW: I 


NONAM Fe RAS 1 42 14-ANUG-72 7 K 
TFASH . 553 62 L4-AlNIG-72 2? « 
ETI . 19 64 15-4ANG-72 ? 


CONFIRM: yY 

SAVE ALL DISK FILES3 10 RLOCKS IN fISFs 490 FREF 

JOP 1 USER 140,192 LOCGFPE OFF KRE AT L5-ANC-72 12:31 A™ 
SYSTFY FETS VAAW11 SYSTEM #714 

FUN TIMF GAS 167 SFCONDS 

FLAPSEFT: TIMF WAS 2 MINUTES» 45 SECONES 

COO MORNING 


Upon logging the user out of the system, RSTS-11 deletes, from the disk, any temporary 
files which have been created by the system for the user. Any files created by the user and 


still remaining open on disk (or any I/O device) are closed and saved for future reference. 


Before leaving the terminal, the user. should turn the LINE~OFF-LOCAL knob! to OFF, 
(Turning the knob to LOCAL means that the Teletype terminal has power, but is not connected 


to the system. It then operates as a typewriter.) 


2.1.4 Commands That Can Be Given Without Logging into the System 


As long as the RSTS-11 system is in operation, anyone can turn a terminal on-line and 


give one of the commands described in Table 2-1. 


Any of the commands in Table 2-1 can be issued from a terminal prior to logging into the 
system, although the full capabilities of the system program may only be available to a user 
already logged into the system. For details, see the appropriate section on the individual 


system program. 


TAgain, instructions refer to the ASR-33 and ASR-35 Teletype terminal. Any other terminal 
being used should be turned off-line and powered down when not in use. 


Table 2-1 
Logged-Out RSTS-11 Commands 


Command Function 


HELP Causes a text file to be output to the user terminal explain- 
ing how to log into the system and various system features. 


Causes the system to output a system status report to the user 
terminal, using the SYSTAT system program. See section 4.3. 


Allows the user to set the characteristics of the user terminal, 
using the TTYSET system program. xxxx is one of the accep- 
table TTYSET arguments, see section 4.5. 


Allows the user to enter the system. Requires the knowledge 
of a legal account number set and the associated password. 
Causes the LOGIN system program to be run, see section 4.1. 


2.2 CREATING A BASIC-PLUS PROGRAM 


2.2.1 NEW Command 


In order to create a new user program, the user issues the NEW command: 
NEW 
followed by the RETURN key. The system responds by printing: 
NEW FILE NAME -- 
to which the user responds by typing the name of the new program. No filename extension is 


required (or accepted) at this point. The SAVE and COMPILE commands automatically append 


the correct filename extension. 
Alternatively, the user can give the NEW command followed by the program name, to 
avoid having the system prompt typing of the program name. The command: 
NEW PROG 
is equivalent to the sequence: 


NEW 
NEW FILE NAME -- PROG 


When the NEW command sequence is entered to the system, it: 


a. Deletes any program currently in memory, and 


b. Causes RSTS-11 to store the new program name. 
The command of the form: 
NEW DT@:BOGLE 


is meaningless. New programs are input from the user terminal only. The OLD command is used 
to input programs from other devices. No system check is made of an existing file of the name 
given in the NEW command. All checking for duplicate file names occurs when the SAVE com- 


mand is given, 


The user has the option of typing the RETURN key instead of indicating a filename. This 
causes RSTS-11 to create a file called NONAME which can be saved or compiled and referenced 
later as NONAME.BAS or NONAME, BAC, This name can be changed at any time (see sec- 
tions 2.2.3 and 2.4.3). The creation of the file NONAME is shown below (the RETURN key, 
although typed, does not echo): 


NEW 
NEW FILE NAME -- 


READY 


If the SAVE command is issued at this point, it will create the file NONAME.BAS, 


2.2.2 Input of the New Program 

Once the NEW command has been given and a new file created in memory, the user has 
the option of typing the program into the system or entering the program from a pre-punched 
1 


paper tape through the terminal low-speed reader. 


If the user is typing his program into the system, he will likely want to use the RSTS-11 
editing features (section 2.2.3) and the LIST and DELETE commands (sections 2.2.4 and 2.2.5). 


Information on how to use the low-speed terminal reader is found in sections 2.6.1 and 5.1.4. 


IThe ASR-33 Teletype terminal has a low-speed punched paper tape reader. RSTS-11 considers 


input from the Teletype paper tape reader equivalent to input from the terminal keyboard. 


2.2.3 Editing BASIC-PLUS Programs 


While typing a program at the terminal, or after a source program is brought into memory 
or run, changes can be made in the source program text. These changes are made in what is 
called the editing phase of BASIC, between the time when the system prints READY and the time 
when the user types RUN. (During this phase, system commands and immediate mode statements 


can be executed.) 


The simplest type of correction is done during the typing of a line, before the line is 


entered fo the system with the RETURN key. For example: 
19 DEF FUN(X) 


If the user realizes that he has typed F UN instead of FNU, he can type the RUBOUT key once 
for each character to be erased. The RUBOUT key causes the erased character to be echoed on 


the user terminal between backslashes as they are erased. For example: 

18 DEF FUN(X<Rubout ><Rubout ><Rubout ><Rubout> NU (X)-Xt* 2*X/2 + X/2 
Typing the above is printed on the terminal as follows: 

18 DEF FUN(X\X(NU\ NUX)=Xt 2*X/2 + X/2 
If the RETURN key is typed at the end of the above line, the system would receive it as follows: 


18 DEF FNU(X)=X+4 2*X/2 + X/2 


Frequently it is easier to delete the entire line, rather than type the RUBOUT key several times. 
If the user has not yet entered the line to RSTS-11 with the RETURN key, he can type CTRL/U 
(see section 3.6 ), which erases the entire current physical line. If the RETURN key has been 
typed, the line can be retyped, and the second version will replace the first in the computer 


memory. For example: 


20 LET X = 44.2 : A 
26 LET X= 45.2 : A 


26.61 
26.61 : B 


w 
| 


= "ABC" 
"ABC" 


If these two lines are typed in succession, only the second line is retained by the system. 
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2.2.4 LIST Command 
The LIST command is used to obtain a clean printed copy of all or part of the user's current 
program at the user terminal, This is especially useful during and after an editing session in 


which the original program is changed. 


In order to obtain a printed copy of the entire program as it currently exists within the 


system, type: 
LIST 


When listing the whole program, source lines are printed in line number sequence regard- 
less of the order in which the lines were entered. In order to list a single line, type LIST follow- 


ed by the line number. 


LIST 198 


obtains a printed copy of line 19g. 
In order to list a section of the program, type LIST followed by two line numbers separated 


by a dash. 


LIST 188 - 200 


lists all program lines from line number 18 to line number 206, inclusive. If 10d and/or 200 
do not exist in the program, any lines within the range 186 to 200 are listed. 


One or more single lines or program sections can be specified in a single LIST command 


by separating the individual elements with commas. For example: 


LIST 25, 36, 58-75, 95, 106-158 


causes single lines 25, 30, and 95 to be printed along with the program lines between 58 and 75 
and between 186 and 158 . Lines or program sections need not be indicated in sequential order 


in the LIST command, but the printed lines appear in the order requested. 


In each of the previous examples, BASIC prints a program header containing the program name 


and the current system date and time. If this header material is not desired (as it might not be 
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during normal editing), the command may be given as LISTNH to delete the header material. To 


summarize: 


LIST Command 
LIST 

LISTNH 

LIST n 
LISTNH n 
LIST nI-n2 
LISTNH nI-n2 


Meaning 
List the entire user program as it currently exists. 
Same as LIST, but without the program header. 
List linen. 
List line n without the program header. 
List lines nl] through n2, inclusive 


List lines n1 through n2, inclusive, without the program header. 


Extensive examples of program listings are shown in the BASIC-PLUS Language Manual. 


In listing a program, the ? character is printed at the left of each line which RSTS-11 


considers to be in error. For example: 


LISTNH 
ID LET A,B = 25 
226 PPRINT A+B 


The LIST command sends output to the user terminal only. If a line printer is available on 


the system, 


SAVE LP: 


is the fastest way to obtain a complete program listing. (See Section 2.4.1.) 


2.2.5 DELETE Command 


The DELETE command is used to remove one or more lines from the current user program. 


For example: 


DELETE 196 


causes line number 180 to be deleted. 


DELETE 180 ~ 200 


causes all program lines between and including line numbers 108 and 280 to be deleted. If 196 
and/or 266 do not exist in the program, any lines within the range from 186 to 200 are deleted. 
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If several lines or groups of lines are to be deleted, the user can separate the individual 


elements with commas, as follows: 
DELETE 100-268, 25°, 306-406, 476, 1086-1100, 475 


which deletes all lines between 18% and 296, line 255, lines 300 to 40, lines 476 and 475, 
and lines 168 to 118%. Lines or program segments to be deleted need not be listed in sequential 
order in the DELETE command. 


If only one line is to be deleted, it may be more convenient merely to type the line number 


and the RETURN key as follows: 
1g 

which is equivalent to: 
DELETE 19 


Before deleting any line, the user should be certain that no other line references the de- 
leted line (such as a GOTO statement), unless the deleted line is to be replaced. A reference 


to a missing line number will generate an error message when the program is run, halting execution. 


2.2.6 RENAME Command 
The RENAME command causes the name of the program currently in core to be changed to 


the specified name. For example: 
RENAME NEWNAM 


The old name of the program currently in memory is discarded. The current program is now known 


as NEWNAM,. If the SAVE command is given at this point: 
SAVE 


the file NEWNAM.BAS is stored on the system disk. 


2.2.7 Debugging BASIC-PLUS Programs 


The phase of program development during which the user is testing the program is called 
the debuggin , ~hase. Rather than repeatedly executing the program with minor alterations on 
each cycle, debugging can be facilitated by placing STOP statements at strategic places 
throughout the program. When the program is executed, each STOP statement causes a program 


halt, and the message: 
STOP AT LINE 58 


is printed, In the above case, the STOP statement was located at line 58. The user at a RSTS-11 


terminal canthen use immediate mode instructions to examine and/or change data values. 


Issuing the CONT command causes program execution fo continue at the next statement 


following the last STOP statement executed. 


Once a program is successfully debugged, the extraneous STOP statements can be removed 


with the DELETE command. 


Typing CTRL/C (see Section 3.5) also causes program execution to halt, but there is less 
control over where the program halts. The system prints READY and the CONT command can be 
issued. In this case the program may or may not be able to continue depending upon the program 


status when the CTRL/C was entered. 


When debugging a program with considerable amounts of terminal output, CTRL/O can be 


used as a switch to stop and restart such output (see Section 3.7). 
2.2.8 CONT Command 


As explained in Section 2.2.7, the STOP statement and CTRL/C can be used to cause execu- 
tion halts in a user program. Immediate mode examination of values or changes can then be per- 
formed, and the program restarted at the statement following the last executed statement 
by giving the 

CONT 


command, followed by the RETURN key. When the CONT command is entered, the system 
attempts fo continue program execution whenever possible. (This is also true of program halts 
due to execution errors. Following the printing of some error messages, the CONT command may 


cause program execution to be resumed.) If it is not possible to continue program execution for 


any reason (e.g. the user has modified the memory through immediate mode statements after 


stopping), the 
CAN'T CONTINUE 
message is printed, 
2.3 EXECUTING A BASIC-PLUS PROGRAM 
2.3.1 RUN Command 


The RUN command is used to cause the execution of any source or compiled BASIC-PLUS 
program under RSTS-11. (Source programs are stored as typed by the user; compiled programs 


are described in Section 2.3.3.) 
In order to run the program currently in memory, the user simply types: 
RUN 


This causes the execution of the program. A program header is printed after the RUN 
command is given, consisting of the program name and the current system date and time. 


If this information is not desired, the command: 
RUNNH 
should be given. RUNNH executes the current program without printing the header material. 
Where it is desired to run a program not currently in memory, the command: 
RUN FILEV3 


can be given. This command causes RSTS-11 to search for the file FILEV3.BAC or FILEV3.BAS 


on the system disk; load, compile (if necessary), and run it (if the file is found). 


If FILEV3.BAS (source) and FILEV3.BAC (compiled) both exist, RSTS-11 loads and 
executes FILEV3.BAC since it requires less time. In order to retrieve and execute FILEV3.BAS, 
it is necessary to issue separate OLD and RUN commands or a RUN FILEV3.BAS command. The 


file is then available for any editing to be performed. 
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If FILEV3.BAS exists but FILEV3.BAC does not, then the command 
RUN FILEV3 
loads, compiles and executes FILEV3.BAS. 


Where the file to be run is not present on the system disk, but is stored on another device, 


the format: 


RUN dev:FILNAM 


is used where dev: is the designation of the storage device. For example: 


RUN DTI: TRANS 


which runs the file TRANS,BAS if found on DECtape unit 1. The statement: 


RUN PR: 


reads a BASIC program from the high speed reader and runs it. Since PR: is an input-only 


(non-file structured) device, no filename need be specified. 


if a filename is specified, that filename is used as the current program name when the 
program is read into memory. However, if no filename is specified, the file in memory will 
have no name and no SAVE command, or any other command referencing a filename, can be 
issued without assigning a name to that file (see the RENAME command, Section 2.2.6). The 


same results occur when issuing the command: 


RUN CR: 


NOTE 


The card reader can detect the absence of cards 

in the card reader; however, the paper tape reader 
is unable to distinguish between the absence of 
tape in the reader and the reader being off-line. 
In both cases an: 


END OF FILE ON DEVICE 
error is printed, following which a file with no 


name and containing no statements exists in the 
user's memory. 


2.3.2 Program Segmenting, CHAIN Statement 


If a user program is too large to be loaded into core and run in one operation, the user 
can segment the program into two or more separate programs. Each program is assigned a distinct 
name; control can be transferred from one program to another with the CHAIN statement used 


as part of a program or in immediate mode. 
The immediate mode form of the CHAIN statement is: 
CHAIN < string>{<line number>} 


in which <string> is the filename specification of the next program segment and <Zine 
number> specifies the line number in the new program segment at which to begin execution. 


If no line number is specified, execution begins with the lowest numbered line. For example: 
CHAIN "PHASE2" 26 


causes the program file PHASE2 to be executed. Execution begins with line 29 in the file 
PHASE2. The CHAIN command first searches for the file PHASE2.BAC and if that search fails, 
will search for PHASE2.BAS, An extension, device specification and/or project-programmer 


number can be included in the filename specification string. 


Communication between various program segments can be achieved by means of the user's 


file area (see the discussion of virtual array files in the BASIC-PLUS Language Manual.) 


When the CHAIN statement is executed, all currently open files are closed, the new 
program is loaded, and execution continues. The CHAIN command is similar to the RUN 


command with the additional capability of specifying a starting line number. 
2.3.3 COMPILE Command 


Normally, RSTS-11 accepts each line of the user program as it is entered and, if the line 
is syntactically correct, translates the line into a form understood by the RSTS-11 Run Time 
System. (The BASIC-PLUS Compiler produces an intermediate code which is then interpreted by 
the RSTS-11 Run Time System into a form executable on the PDP-11 computer.) As the program 
is edited, only those lines which are changed are recompiled (i.e., translated). When the 
SAVE command is given, only the source version of the program (i.e., text that is typed in 


response to the LIST command) is stored in the .BAS file created. In response tothe OLD 
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command, BASIC reads the text from the saved file and compiles it in the same manner as when 


the program is entered from the user keyboard. 


Once a program is completely developed and debugged, it may be desirable to avoid the 
time-consuming practice of compiling the program every time it is brought into memory, For 
this reason, the COMPILE command has been provided. COMPILE permits the user to save an 
image of his compiled program, rather than (or in addition to) the source text of the program. 
This compiled version of the program is stored with the filename extension .BAC and can be 


read from the system device and executed with a minimum of overhead. (See Section 2.3.1.) 


NOTE 


Compiled files have a minimum size requirement 
of 11 blocks. This size may be greater than 
necessary to actually store the compiled (or 
even source) version of a short program. In such 
cases the user should be aware that he is trading 
disk space for execution speed. 


Due to the transformation that takes place when a program is compiled, a file with the 
extension .BAC can only be executed; it cannot be edited. Therefore, the user can issue the 
RUN command with respect to compiled files, but the file cannot be retrieved with the OLD 


command. 


If the current filename (i.e., that which is typed as part of the header listing) is FILE@1, 


then the command: 
COMPILE 


saves the compiled program in a file named FILE@1.BAC on the system disk. If another name is 


desired for the compiled file, it can be specified. For example: 
COMPILE PROG 


generates a file PROG.BAC on the system disk. Compiled programs are output only to the 
system disk. 1 The COMPILE command causes the filename extension .BAC to be appended to 


the current or specified filename for storage in the user's disk library. Compiled files are 


] es s , 
A privileged user can obtain a copy of a compiled file on another device, using the PIP 
system program. 
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stored with a default protection of <68> . To obtain any other protection code, that code 


must be explicitly specified. For example: 
COMPILE <46> 


creates a file on the system disk having the current filename, a .BAC extension, and a protection 
code of <4@> . At any time protection codes can be altered with the NAME-AS command or 


the PIP system program. 
2.4 PROGRAM FILE MANIPULATION 
2.4.1 SAVE Command 
The SAVE command is used to store BASIC-PLUS source programs on the disk as follows: 


SAVE 
The program currently in memory is saved on the system disk under its current filename with the 


extension .BAS. If a file of the same name exists, the system returns the error message: 


FILE EXISTS-USE REPLACE 


This message is designed to protect the user against inadvertently destroying an existing file. 
Where the current filename is not the desired name, the format: 


SAVE FILNAM 
can be used, which saves the program currently in memory on the system disk under the name 
FILNAM.BAS. The name of the current source program is not stored in memory with any exten~ 
sion (no extension is printed as part of the current filename when a LIST command is given). 


The SAVE command appends the .BAS extension when writing the file to a storage device. 
In cases where the desired storage device is not the system disk, the format: 


SAVE dev: 
or: 
SAVE dev:FILNAM 
is used where dev: indicates a device designation. The file is stored as the current filename or 


as FILNAM.BAS on the indicated device. For example: 
SAVE DT@:ROPE 
saves a copy of the program in memory as the file ROPE.BAS on DECtape unit 8. 


The SAVE command is usable only when a source file is currently in memory. When a 


program is saved, it is still in the computer memory and can be run, changed, or deleted. 
To obtain a listing of the current source program on the line printer, the user can type: 


SAVE LP: 
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To punch a tape of the current source program on the high-speed paper tape punch, the user 


can type: 
SAVE PP: 
No filename specification is needed with an output-only (non-file structured) device. 


To punch a tape on the low-speed punch, give a LISTNH command, turning the punch on- 
line before typing the RETURN key. This is not recommended as the word READY is punched at 
the end of the tape. Tapes punched on the low-speed punch should be read only through the 


low-speed reader. 
2.4.2 Recalling a Saved Program, OLD Command 


To retrieve the source file of a previously saved BASIC-PLUS program, the OLD command 


is issued as follows: 
OLD 
to which the system replies: 
OLD FILE NAME - - 


The user then types the name of the saved BASIC -PLUS file containing the program. Alternative- 


ly, the user can indicate the old filename without prompting, as follows: 
OLD TAXES 


which calls the saved file TAXES.BAS from the system disk. If the file is not available on the 


disk or if it is protected against the user, an appropriate message is printed. 


Where no filename is indicated, RSTS-11 looks for the file NONAME (which could have 


been created by the user or the system, see Section 2.2.1). For example: 


OLD 
OLD FILE NAME - - 


READY 


Whatever was stored in the file NONAME.BAS for the current user on the system disk is now 


in memory and available to the user. 
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The OLD command can only retrieve BASIC-PLUS source programs (.BAS files), since 
compiled programs (.BAC files) can be run but not changed. Any program called with the OLD 


command can be edited by the user at the terminal. 
2.4.3 File Protection and Renaming, NAME-AS Statement 


The NAME-AS statement can be used in immediate mode to rename and/or assign protec- 
tion codes to a disk or DECtape file and can be used on a file only by someone logged into the 
system under the account number which owns the file. The format of the command is as 


follows: 
NAME <string> AS = <string> 
The specified file, the first <string> indicated, is renamed as the second <string> indicated. 


Where the file resides on a device other than the default device (system disk), the device 
must be specified in the first string and may optionally be specified in the second string. No 
filename extension assumptions are made by NAME-AS; the filename extension must be specified 


in both strings if arly extension is present in the filename. For example: 
NAME "DT@:OLD.BAS" AS "NEW.BAS" 

is equivalent to: 
NAME "DT@:OLD.BAS" AS "“DT@:NEW.BAS" 

but the siceSacali 
NAME "FILET.BAS" AS "FILE2" 


is not advised since FILE2 has no extension and could not subsequently be called into core 


via the OLD or RUN commands (which require filename extensions) . 


A file protection code can be specified within typed angle brackets as part of the second 
string although it is not required. If a new file protection code is specified, it is reflected in 
the protection assigned to the renamed file. If no new protection code is specified, the old 
protection code is retained. See the BASIC-PLUS Language Manual for a complete description 


of protection codes. 
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NAME "FILE,EXT" AS "FILE,EXT < 46>" 
changes only the protection code of the file FILE,EXT stored on the system disk. 
NAME "DT@:ABC.BAS" AS "XYZ,BAS" 


changes the name of the file ABC,BAS on DECtape unit . Since no transfer of the file from 
one device to another can be performed with the NAME-AS statement, it is not necessary to 
mention DT@: twice; that is, the device of the new filename need not be specified. (To 


transfer a file between devices use the PIP system program.) 
NAME "NEW" AS "NEW, 1" 
changes only the extension of the disk file NEW (with no extension) to NEW.1. 


2.4.4 System Library Files 


The system library is conventionally stored under account [1,2] ona RSTS-11 
system. The CATALOG$ command can provide each user with a list of those programs 
available in the system library and their protection codes. Rather than specify the [1,2] 
account number as part of the file specification each time a system library program is refer- 
enced, the user may precede a system library filename with the $ character, which is 


synonomous with [1,2]. 


Most system library files are completely write-protected. Unless the file is also read pro- 
tected, the user can issue OLD or RUN commands with respect to system library files, 


remembering that the OLD command can only be used on a source file. For example: 


OLD$ SYSTAT 


or 


OLD $SYSTAT 


(Spaces are not significant in RSTS-11 command strings.) 
is equivalent to: 


OLD [1,2] SYSTAT.BAS 
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and is only legal where SYSTAT is stored as an available source file in the system library. The 


command: 
RUN$ SYSTAT 


will cause the file SYSTAT.BAC to be loaded and executed, if found; and, if SYSTAT.BAC 
does not exist, the file SYSTAT.BAS is loaded, compiled and executed. (Most system library 
files are .BAC files.) 


2.4.5 Removing a Saved Program, UNSAVE Command 
The UNSAVE command is used to remove a file from a storage device. The form: 
UNSAVE FILNAM,BAC 


removes the file FILNAM.BAC from the disk. (The system disk is the default device.) If the 


command is given; 
UNSAVE FILNAM 


BASIC attempts to remove the file FILNAM,BAS. Unless a filename extension is specified in 


the command, an extension of ,BAS is assumed. 
To indicate an alternate storage device, the form: 
UNSAVE  dev:filename. extension 
is used where dev: is the device designation. For example: 


UNSAVE DT1:FLAM 


removes the file FLAM.BAS from DECtape unit 1 if it is found. 


2.4.6 Updating a Saved Program, REPLACE Command 


The REPLACE command is used when the user wishes the program in memory to replace a 


file on the system disk with the same name. The command is of the form: 


REPLACE 
or 


REPLACE FILNAM 
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REPLACE performs the same function as SAVE, but destroys the old copy of the same file, if it 
exists, without notifying the user. REPLACE appends a .BAS filename extension to the filename 
already associated with the file or specified in the REPLACE command. Where a filename spec~ 
ification is given, REPLACE replaces the file on the system disk with the name indicated. In 


this case the name of the current program, as stored in memory, is ignored. 
2.5 SYSTEM STATUS REPORTS 
2.5.1 LENGTH Command 


The LENGTH command returns the length of the user's current program. The user need 


only type: 
LENGTH 
and enter the command to the system with the RETURN key. For example: 


LENGTH 
2K OF CORE USED 


A minimum 2K of memory (IK = 1824 words) is reserved for each user, with a maximum of 8K 
per user in 28K systems and 5K per user in 24K systems. The size of the current program is 


reported to the nearest 1K. 
2.5.2 CATALOG Command 


The CATALOG or CAT command causes a listing of the current user's disk file directory 


to be printed on the requesting user terminal. 


For example: 


CAT 

TTYTST.BAS 4 69 26-JUL-72 26-JUL-72 2:12 PM 
JUNKYT,TST ] 66 26-JUL-72 26-JUL-72 4:66 PM 
TEMP@2 . TMP ] 66 31-JUL-72 31-JUL-72 2:54 PM 
PROG .BAS ] 66 31-JUL-72 31-JUL-72 2:54 PM 
PROGI .BAS ] 66 3]-JUL-72 31-JUL-72 2:59 PM 
PAT BAS ] 66 31-JUL-72 31-JUL-72 93:81 PM 


name extension size in 256- protection last access date creation date creation time 
word blocks code 
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To obtain a catalog of files stored under another user's account number, the command is 


given as: 
CATALOG [196,181] 
which lists the system disk files owned by user account [ 1£@, 191 } 
CATALOG$ 
lists all files in the system library (§ indicates account [1,2], the system library). 
To obtain a catalog of files on a device other than the system disk, give the command: 
CATALOG dev: 


where dev: is a device specification (a user account specification can be included in such a 


command). For example: 
CATALOG DT]: 

lists all files on DECtape unit 1 (no account numbers are associated with DECtape files). 
CATALOG MT1: [266,226 ] 


lists all files stored under account [262, 228] on magtape unit 1. 


2.6 USING RSTS-11 INPUT/OUTPUT DEVICES 
2.6.1 Disable Terminal Echo, TAPE Command 
So eno, PATE Command 


The TAPE command is used to disable the terminal echo feature when reading a paper tape 


with the low-speed (terminal) reader. The command is given as follows: 
TAPE 


followed by the RETURN key. The tape is then inserted in the low-speed reader and the reader 
control switch is set to START. 
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Prior to giving the TAPE command, the user must set up conditions such that the system 
expects the tape input (generally a BASIC-PLUS program, although a data file could also be 


input this way). For example, giving the following commands: 


NEW PROG 
TAPE 


Causes the system to await a source program file to be entered to the system via the terminal 
tape reader. The terminal echo feature is disabled, so the program is not listed on the terminal 


as it is read. This allows input to proceed more quickly than typing: 
NEW PROG 


and then reading the tape through the low-speed reader. A program listing can be obtained on 


a line printer or on the terminal at a later time, if necessary. 
In tape mode the RETURN and RUBOUT key characters are ignored. 


2.6.2 Enable Terminal Echo, KEY Command 


Since no characters input from the terminal keyboard or reader are echoed following the 
TAPE command, the KEY command is supplied to again enable the terminal echo feature. The 
user is advised to type the LINE FEED key before issuing the KEY command in case the last line 


input was not terminated with a carriage return/line feed pair. The command is typed as: 
KEY 
and entered to the system with the LINE FEED or ESCAPE key! . (Carriage return characters are 


ignored when the terminal is in tape mode.) Following successful entry of the KEY command, 


characters are again echo-printed at the user terminal . 


TesCAPE is shown as ALT MODE on some terminals. 
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2.6.3 Seize Device, ASSIGN Command 


The ASSIGN command is used to reserve an I/O device for the use of a single programmer 


(job number). The command is given in the form: 
ASSIGN dev: 


where dev: is the device specification (see Table 2-2). If the device is present on the system 


and available for use, the system returns the message: 
READY 

If the device is not available for use, the message 
DEVICE NOT AVAILABLE 

is returned. For example: 


ASSIGN LP: 

READY 

ASSIGN PR: 

DEVICE NOT AVAILABLE 


If more than one job is logged into the system ynder a single account number, only the user 


(job number) performing an ASSIGN (or DEASSIGN) is affected by that command. 


TABLE 2-2 
DEVICE SPECIFICATIONS 


PR: high-speed paper tape reader 
PP: high-speed paper tape punch 
CR: card reader 

MT@: to MT7: magtape units % to 7 

LP: line printer 

DT@: to DT7: DECtape units ff to 7 

KB: current user terminal 

KBn: | Teletype n in the system 


NOTE 


the user can reference DTn: and MTn: where 
n is between @ and the maximum number of 
such units on the system. For example, 

normally only DT@: and DTI: can be refer- 
enced on a RSTS-11 system. 
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2.6.4 Release Device, DEASSIGN Command 


The DEASSIGN command is used to release the specified device to the device pool within 
the system (for use by other jobs). If no device is specified, all assigned devices are released 


from that user (job number). For example: 
DEASSIGN LP: 

releases the line printer. 
DEASSIGN 


releases all devices previously assigned by that user (under the current job number). If a 
DEASSIGN command is not given before the user leaves the system, an automatic DEASSIGN 


is performed when the user gives the BYE command. 
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CHAPTER 3 
SPECIAL CONTROL CHARACTERS 
3.1 RETURN KEY 


Typing the RETURN key echoes as a carriage return/line feed operation on the terminal, 
as long as the terminal is not in tape mode. The RETURN key is normally used to terminate a 
line and enter that line to the system. In tape mode (following entry of the TAPE command) all 


carriage returns are ignored, 
3.2 ESCAPE OR ALT MODE KEY 


The ESCAPE key, like the RETURN key, is used to terminate the current line and causes 
the line to be entered to the system. However, the ESCAPE key echoes on the terminal paper 
as a $ character and does not perform a carriage return/line feed. ESCAPE is used to enter the 


KEY command to the system. 


On some terminals the ESCAPE key is replaced by the ALT MODE key, which performs 


the same functions. 
3.3 LINE FEED KEY 


The LINE FEED key is generally used to continue the current logical line of input on an 
additional physical line. The LINE FEED key does not echo on the terminal paper but does per- 
form a carriage return/line feed operation when used with the RSTS-11 system. Typing the LINE 
FEED key automatically generates a physical, but not logical, carriage return/line feed sequence; 


so the LINE FEED is not used to terminate or enter lines to the system (except for the KEY command). 


LINE FEEDs produce errors in programs if included in constants (including string constants), 


verbs, or user-specified names for variables or functions. 
3.4 RUBOUT KEY 


The RUBOUT key is used as an eraser for the current line. If typed in tape mode, the 
RUBOUT key is ignored; otherwise, it causes the last character typed to be deleted. The erased 


characters are echoed on the terminal paper between backslashes. For example: 


1@ LEF X=X*X 
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could be corrected by typing the RUBOUT key 7 times (to remove the F) and typing the remain- 


der of the line correctly. The line would look as follows on the terminal paper: 
18 LEF X=X*X\X*X=X FLT X=X*X 

and would appear to the system as: 
18 LET X=X*X 


In cases where the mistake is toward the beginning of a line, it may be easier to simply retype 


the entire line. For example: 


1@ LEF X=X*X 
1@ LET X=X*X 


Once the second line is entered to the system, the first line number 18 is deleted. 


RUBOUT can be used on any input line to the RSTS-11 system, including commands, as 
long as the line has not been entered to the system with RETURN or ESCAPE. 


3.5 CTRL/C 

Typing a CTRL/C (hold down the CTRL key and type the C key, release both) causes 
RSTS~11 to print READY and return to command mode where commands can be given or editing 
done. CTRL/C stops whatever RSTS-11 was doing at the time (execution or output) and returns 
control of the system to the user. 

Note that CTRL/C interrupts processing. For example, if CTRL/C is used after the REPLACE 
command is issued and before the READY reply is received, the file is not replaced in its entirety 
and is not closed. Since the file has not been closed, it cannot be accessed later. Similarly, 
if the OLD command is issued and a list of error messages is being printed, the CTRL/C key 


should not be used since the current program is only half compiled at that point. 
3.6 CTRL/U 
The CTRL/U combination deletes the current input line. This is useful when a long command 


has been typed and is seen to be incorrect. Rather than use the RUBOUT key repeatedly, CTRL/U 


deletes the entire line. This feature can be used when typing either commands or statements. 
CTRL/U deletes the entire current physical line. For example: 


1g LEW Atu 

26 LET A= 

23.41U 

LISTNH 

SYNTAX ERROR AT LINE 26 


READY 
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In typing line 18 a mistake was made and the line deleted with CTRL/U (notice that the line 
does not appear in the program listing following LISTNH). In typing line 28, the LINE FEED 
key was used to continue line 26 onto a second line. A physical line has been terminated , 
The logical statement at line 24, however, is continued onto the following line and its 


deletion with a CTRL/U causes the statement at line 28 to be entered as: 
26 LET A = 


which is syntactically incomplete. Had the last line been terminated with the RETURN key it 


would be entered to the system as; 


26 LET A = 
23.4 


which would be accepted as equivalent to: 
26 LET A = 23.4 
3.7 CTRL/O 


The CTRL/O combination suppresses output to the terminal until the next time CTRL/O 
is typed. When a program produces a large amount of output (usually tabular form), the user 
may not wish to wait for the printing of the complete information. CTRL/O enables the user to 
monitor the output while not stopping it completely. Typing CTRL/O while output is occuring 
still allows the computer to output the data, but the terminal does not print it. This speeds up 
the output process, since terminals are normally slow devices. The second time CTRL/O is 


typed, the output is again printed at the terminal. 


CTRL/C, on the other hand, completely terminates program output. Think of CTRL/O 
as a switch, the first setting of which creates a condition and the second setting releases the 


condition. 
3.8 TAB CHARACTER 


The TAB character or CTRL/I combination allows the user to insert a tabular format into 
his typed material, When entering a program to the system, the TAB character allows format- 
ting such as shown in Figure 3-1. The RSTS-11 editor considers each Teletype line to contain 
eight tab stops, eight spaces apart, across the line. Typing the TAB character causes the printer 


head to move to the next tab stop on the current line. 


If using a model ASR-33 or KSR-33 Teletype, typing the TAB character echoes the 
appropriate number of spaces to reach the next tab stop. The model 35 Teletypes have hardware 
tab stops. (See the description of the TTYSET system program for a means to enable or disable 
hardware tabstops.) 


3.9 CTRL/Z 


The CTRL/Z combination is used to mark the end of a data file. When data is input from 
a file, the CTRL/Z character marks the end of recorded data. The message "END OF FILE ON 
DEVICE" is printed by the system when a +Z is detected unless an ON ERROR GOTO statement 
is used to enable a BASIC-PLUS routine to handle the error (ERR = 11). 


24 [F f>P THEN 
IF #>C THEN PRINT ta>roc™ 
FLEE [Tk (>A 
THEN PRINT 'C>A>ke 


FLEE PRIN, "a>t>ke 
FLOF [Tk A>C THEY PEIVT "Tae? 
RLSk Pr Poe 
GHEY rkivi "hec>e" 
FLEE bRiNT "O> toa" 


Figure 3-1 TAB Character Example 
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CHAPTER 4 
RSTS-11 SYSTEM PROGRAMS 


In addition to the core-resident BASIC Compiler, there are several disk-resident system 


programs available on RSTS-11. The list of programs includes the following: 


LOGIN allows users to enter the system. 
LOGOUT allows users to leave the system. 


SYSTAT provides system status summaries. 

PIP moves data from one peripheral device to another . 

TTYSET allows the user to specify functional characteristics of the user ter- 
minal. 

GRIPE allows the user to log complaints or comments about the system . 


QUOLST allows the user to determine his current disk quota and the amount of 
file space in each system device. 


MONEY allows the user to determine the amount of time charged to his account 
number. 


The functions and techniques for using each program are described in the following sections. 


This Chapter was designed in a modular format so that the system manager could remove or 
add sections depending upon the needs of the individual installation. (The Table of Contents 
reflects the material supplied by DEC.) 


4.1 LOGIN PROGRAM 


The LOGIN program is started when the command HELLO is typed at a user terminal or 
when any line is entered from a logged-out terminal. LOGIN connects a user terminal to 
RSTS-11, attaches a user to another job already running within the system, or permits the user 
to run designated system programs from a logged-out terminal. LOGIN can be called when the 


user first logs into the system or after the user is already logged into the system. 


The following are acceptable inputs from a logged-out terminal : 


Input Meaning Manual Section 
User wants to log into the system. 
User wants a printed description of how to use the system. 


Dataset has been answered and wants to log into the system. 
If the system has an automatic answering facility for remote 


terminals, the | character is inserted into the user input 
buffer by the system. 


other Undefined. LOGIN prints the message: PLEASE SAY HELLO. 


SYS User wants a system status report. 


SET xxxx User wants to set characteristics for that terminal . 


If the user input is SET xxxx or SYS, RSTS-11 attempts to run the system program requested. 
Only those programs listed above or others specified by the system manager can run while logged 


out of the system (see section 2.1.4). 


In response to the HELLO command or the automatically inserted | character, where the 
issuing terminal is not logged into the system, the LOGIN program is started and performs the 


following: 


a. LOGIN prints the following information at the user terminal: the job number, key- 
board number, system version, and current system date and time. 


b. | LOGIN then requests the user account number by printing a * character. The user 
types his project and programmer numbers in that order separated by a comma and 
terminated with the RETURN key. (Separating the numbers with a slash inhibits the 
printing of any opening system messages.) The user can specify his project-program- 
mer numbers on the same line as the HELLO command; for example: 


HELLO —=_:188, 18 


(In this case, the system does not print # and only prompts the user to type his 
password, as shown below.) 


4-2 


c. LOGIN then requests a password by printing: 
PASSWORD: 
The password typed by the user does not echo at the terminal. 


d. If the account number and password are a valid entry, the user is logged into the 
system. If the codes typed by the user are not an acceptable entry, the message: 


INVALID ENTRY - TRY AGAIN 
# 


is printed and the user can try entering another account combination. 


e. _ If there are any detached jobs! with the current account number, LOGIN then 
informs the user and permits him to attach to one of those jobs (thus killing his 
current job number and removing it from the system). See the description below 
of attaching to another job. 


f. If the user does not attach to another job, LOGIN prints the message of the day, 
if any. 


g. Finally, the system prints 
NEW OR OLD - - 
to indicate that it is ready to accept command input. 


The complete sequence is shown below: 


HELLO 
RSTS V4A~11 SYSTEM #213 JOB 3 KB@ 65-SEP-72 4:25 AM 
#190, 100 

PASSWORD: 

WELCOME TO RSTS-11 ! 


NEW OR OLD-- 


"s job becomes detached either because of a dataphone disconnect affecting a remote user or 
due to deliberate action by deliberate use of a certain system function within that job program. 
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if the HELLO command is input from a terminal already logged into the system, LOGIN 


performs the following: 


a. | LOGIN prints two lines identifying the system version, job number, keyboard, date, 
time and account number. 


b. If there are any detached jobs with the current account number, LOGIN permits 
the user to attach to one of those jobs (which kills his current job number and re- 
moves it from the system). The job number to be typed by the user is the job number 
as printed by the system following the HELLO command. For example: 


HELLO 

RSTS-11 V4A-65 SYSTEM #213 JOB 3 KB4 10-SEP-72 18:06 AM 
YOU ARE LOGGED IN UNDER OQ, 168 

JOB(S) 2 ARE DETACHED UNDER THIS ACCOUNT 

TYPE JOB NUMBER TO ATTACH TO? 2 

ATTACHING TO JOB 2 


The job number specified must be the original job number assigned when the current- 
ly detached job was logged into the system. 


¢.  Toavoid attaching to another job, type the RETURN key instead of specif'ying a 
job number. 


4.2 LOGOUT PROGRAM 


LOGOUT is called when the user has completed all processing and is ready to leave the 
terminal. The LOGOUT program is started when the BYE command is typed at a user terminal 
logged into the RSTS-11 system. LOGOUT checks the current user's disk quota to ensure that 
the user does not log out of the system with more than the acceptable amount of disk storage 
being used for his files. If the user's disk files are within the acceptable disk quota size, 
LOGOUT disconnects the terminal from the system, removes the current job number from the 


list of active jobs and prints some information on the duration of the current job. 
In response to the BYE command, LOGOUT prints: 
CONFIRM: 


The user can give any of the following responses: 


Table 4-1 


LOGOUT CONFIRM: Responses 


CONFIRM: Response Meaning 


These responses indicate that-the user does not want to log out of 
the system. The LOGOUT procedure is terminated without logging 
the user off the system and the system prints NEW or OLD-- 


Causes the system to print an explanation of the acceptable responses 


to CONFIRM: 


Causes the system to print a message instructing the user to type ? 
to obtain a description of logout procedures. 


Causes LOGOUT to enter individual file deletion mode, 


Causes the user to be logged out of the system as long as his disk 
storage space is within the acceptable limits. 


In individual file deletion mode, LOGOUT prints the name, size, protection code, and 


creation date of each file stored under the current user account number on the system disk. This 
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information is followed by a ? after which the system awaits a response from the user which 


can be: 


File Deletion 
Mode Response 


RETURN key Save the file just listed. 


K Delete (kill) the file just listed. 


An example of a LOGOUT sequence is shown below: 


BYE 

CONFIRM: YES 

DISK QUOTA OF 50 EXCEEDED BY 18 BLOCKS 

SOME FILE(S) MUST BE DELETED BEFORE LOGGING OUT 


CONFIRM: | 

FOOBAR, BAS 456 66 18-JAN-72  ? 
FOO «TMP 66 68 1-JAN-72. 2? K 
CONFIRM: YES 


SAVED ALL DISK FILES: 458 BLOCKS IN USE, 58 FREE 

JOB 1 USER 186,188 LOGGED OFF KB4 AT 1@-JAN-72 16:86 AM 
SYSTEM RSTS-11 V4A-65 SYSTEM #213 

RUN TIME WAS 71 MINUTE, 28.1 SECONDS 

ELAPSED TIME WAS 26 MINUTES. 15 SECONDS 

GOOD MORNING 


LOGOUT statistics for a detached job, or a job which was detached at any time, include 


accumulated run time and elapsed time statistics. 


4.3 SYSTAT PROGRAM 


The SYSTAT program provides current system information in the areas of job, device, 
disk, and buffer status. SYSTAT can be called by a user logged into the system or from a ter- 


minal which is on-line but not logged into the system. 
To start SYSTAT while logged into the system, type: 
RUN $SYSTAT 
If not logged into the system, type: 
SYS 


If the user is already logged in, the system responds by printing: 


OUTPUT STATUS TO? 


at which point the user can indicate any RSTS-11 device or a filename specification for the 


status report output. Possible replies by a user logged into the system are described below: 
SYSTAT Output Response Meaning 
send status report to the line printer . 


send status report to the user terminal. (The RETURN key is equivalent 
to responding KBs) 


send status report to user terminal n in the system if that terminal is 
on-line and not currently in use. 


send status report to the high-speed paper tape punch. 


dev:filename. ext send the status report to the file specified. The default device is the 
system device. No extension is appended unless specified by the user. 


If SYSTAT is run by a user not logged into the system, the report is always sent to the user 


terminal requesting the report. 


Following the device or filename specification, the user can specify one of the options 
in Table 4-2 to obtain a partial system status report. The option specifications are preceded 
by a slash if the user is logged into the system. The options can be typed following the SYS 


command if the user is not logged into the system. 


Table 4-2 


SYSTAT Options 


SYSTAT Option 
Specification Meaning 
report only job status 
report only busy device status 
report only disk status 
report only free buffer status 
report only the status of terminal n in the system 


report only the status of detached jobs! 


report only the status of any jobs active under account [n,m] 


report only the status of jobs not logged into the system 


The options $,B,D, and F can be specified as separate options or in any combination. 
The following examples are performed on a terminal logged into the system: 


RUN$ SYSTAT 
OUTPUT STATUS TO? LP: /3 causes output of a status report for job 3 to the line printer . 


RUN$ SYSTAT 


OUTPUT STATUS TO? ~=/D causes output of disk status report to the user terminal. 

RUN$ SYSTAT 

OUTPUT STATUS TO? = =//SF causes output of job and free buffer status to the user 
terminal. 


The following examples are performed on a terminal not logged into the system: 


SYS causes output of complete system status report to the terminal. 

SYS D causes output of the disk status report to the terminal. 

SYS BF causes output of the busy device and free buffer status reports to the 
terminal, 

SYS SBDF equivalent to not specifying any options; a complete system status 


report is output to the terminal. 


SYS 5 causes output of a status report for job 5to the terminal. 


"Normally, a job is detached only by use of a certain system function or because of a dataphone 
disconnect affecting a remote user. 
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A complete system status report is shown below: 


RUN$S YSTAT 
OUTPUT STATUS TO? 


RSTS V4A-11 SYSTEM #213 STATUS ON $5-SEP-72 AT 64:42 AM UP: 1:34:42 


JOB WHO WHERE WHAT SIZE STATE RUN-TIME 
1 186, 191 KB6 LOGOUT 2K RN SW 6.7 
2 188, 168 KBIg NONAME 2K KB .9 
3 166, 186 KBO SYSTAT 5K RN £.9 
4 1, 18 KB9 MONEY SK FP £.3 


BUSY DEVICES: 
DEVICE JOB WHY 


LP 1 AS 

DISK STRUCTURE: 

DISK OPEN FREE CLUSTER ERRORS COMMENTS 
DKg p 686 1 g PUBLIC 

DK1 2 139 2 y) PRIVATE 


SMALL LARGE ERRORS HUNG TTY'S 
43 1 p 1) 


READY 


Run time is given in 


hours: minutes: seconds. tenths of seconds 
For example: 

1:23.4 
indicates one minute, 23.4 seconds of run time. 


The job status information includes a list of all current active jobs by job number. 
Associated with each job number are the account number, the keyboard number, the current 


program name and size, the job state and elapsed run time associated with that job. 


The device status information reports devices which are busy, having been assigned. or 
opened by a specific user. Items reported are the device specification, the job owning that 


device, and the condition of the device. 
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The disk status information describes each disk (public and private) currently mounted. 
Items reported are: disk name (device specification), number of open files, number of free 
512-byte blocks, pack cluster size, disk hardware error count, and the public/private and 


locked/unlocked status of the device. 


The buffer status provides information on the number of small (16-word) and large (256- 
word) buffers currently not in use, catastrophic error count, and a count of the number of times 
a hung terminal was found. A hung terminal is one which fails to respond to character transmis- 
sion within a given time period. The system attempts to unhang the terminal and increments 


the hung terminal count. 


The abbreviations used inthe SYSTAT report are defined in Table 4-3. 


Table 4-3 
SYSTAT abbreviations 


Abbreviation Meaning 


DET job is detached from all terminals 

ee job is not logged into the system but is running LOGIN, SYSTAT,or 
TTYSET 

SW job is swapped out (not currently in core) 

RN job is running or waiting to run 

RS job is waiting for residency following an I/O operation 

HB job is detached (waiting to be attached) 

FP job is wai ting for file processing action by the system. 

SL job is sleeping (SLEEP statement) 

CR job is waiting for card reader input 

MT job is waiting for magtape 1/O 

LP job is waiting to perform line printer output 

DT job is waiting for DECtape I/O 

PP job is waiting to perform output on the high-speed paper tape punch 

PR job is waiting for input from the high-speed paper tape reader 

TT job is waiting to perform output to a terminal 

KB job is waiting for input from a terminal 

DF job is waiting to perform disk I/0 

AS device is explicitly assigned to a job 


device is open on a channel 


4,4 PIP PROGRAM 


The PIP (Peripheral Interchange Program ) system program performs disk and peripheral 
device transfers as well as several other file utility functions. Two forms of the PIP program are 
available; the only difference being that one contains Record I/O copy options and is present 
only on systems having the Record I/O feature. Non-Record |/O PIP can perform only formatted 
ASCII file transfers. (RSTS-11 PIP commands, wherever possible, have been made compatible 
with DOS~11 PIP commands). 


PIP can only be called by users logged into the system as follows: 
RUN$ PIP 


PIP responds by identifying itself and printing an asterisk to indicate that it is able to accept 


input commands: 
PIP RSTS V4A-11 SYSTEM #213 
* 
In order to return to the RSTS-11 Monitor, type CTRL/C or CTRL/Z. The system responds 
by printing READY. For example: 


BAZ 
READY 


A CTRL/Z is equivalent to an End-of-File on the user terminal and causes an orderly exit from 


PIP, as does CTRL/C. 


4.4.1 PIP Command Line Specifications 


Spaces and tabs within a PIP command line are ignored. PIP commands must be typed on a single 


line and be no more than 8 characters long. 
Output file specifications are of the form: 
dev: [proj, prog] name.ext < prot > 


The elements of the output file specification are described in Table 44, Input file specifica- 


tions are of the form: 
dev: [proj, prog] name.ext 


Elements of the input file specification are described in Table 4-5. 
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Table 4-4 


Output File Specification Elements 


Element Description Default 
dev: device specification system disk (DF:) 
[proj,prog] | account specification, project- 
programmer number current user account number 
name filename specification! none 
: Pe 
ext filename extension none 
<prot > protection code < 6% >, equivalent to read and write protect 


against everyone but the owner 


no specification KB: 


TOutput-only devices (non-file-structured devices) such as KB:, LP: and PP: ignore the file- 
name and extension specifications. 


Table 4-5 


Input File Specification Elements 
Element Description 


dev: device specification system disk (DF:) 


[ proj, prog] account specification, project- current user account number 
programmer number 


1 


name filename specification none 
ext filename extension! .BAS (BASIC-PLUS source program) 


no specification last file specification is used again. 
Initial default is DF: 


Mnput-only devices (non-file-structured devices) such as KB:, PR: and CR: ignore 
the filename and extension specifications. 


With PIP there is at most one output file, but there may be any number of input files. 
Where more than one input file is specified, all filenames which are not preceded by a device 
specification are assumed to be on the system disk. A null file specification duplicates the 


immediately preceding file specification in all details. 
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PIP options are specified in the form: 
/option:argument 


Options are always begun with a slash and terminated with a comma (,), left angle bracket (<), 
another slash (/), ora line terminating character (RETURN or ESCAPE). The option argument 
is a function of the individual operation to be performed. The default option is a formatted 


ASCII file transfer. 


4.4.2 File Transfers Including Merge Operations 


File transfer and/or file merge operations take the following command format: 
*output file < input file(s) /option 


Only one output file can be specified. If one input file is specified, a copy of that file 
is transferred to the output file specification (the original input file remains untouched). If 
more than one input file is specified, copies of the files are merged into a single output file 
(the original input files remaining untouched). The options available on a file transfer and/or 


merge operation are described in Table 4~6. 
As an example: 


RUN$ PIP 
PIP RSTS V4A-11 SYSTEM #213 
*DTI:FILET.BAS <FILET, FILE2, PR:, DT@:AA.BAS 


The above command string takes the files FILE? and FILE2 from the system disk, a single file 
from the high-speed paper tape reader and file AA,BAS from the tape reel mounted on DECtape 


unit @ and creates the single file FILET.BAS on the tape reel mounted on DECtape unit 1. 


Since a PIP command must be typed on a single line, the number of files which can be 


merged into a single file is limited only by a command string length of 88 characters. 
4.4.3 Change Filename or Protection Code 


PIP can be used to change a filename specification. The general format for such a command 


is as follows: 
*new file specification = old file specification 


To change the filename, extension and/or protection code of a stored file, type the new file 


specification (including the device specification and, optionally, the protection code), followed 
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Table 4-6 
File Transfer and Merge Options 


Option Function 


no option ASCII file transfer is performed. 
/FA Formatted ASCII transfer is performed (Nulls, parity bits |, 
and RUBOUT's are ignored). 


/BL Block mode transfer is performed using the default block 


sizes. 


/BLin Block mode. transfer is performed using a block which is n 
bytes long. 


/CO Contiguous mode transfer is performed with null fill char- 
acters inserted into any partial buffer remaining. 


/CO:T Contiguous mode transfer is performed with any partial 
buffer remaining being truncated. 


/CLen Set cluster size ton. 
/ GO Ignore 'USER DATA ERROR ON DEVICE! errors. 


/HE Appends '$PIP.TXT' to command line to have PIP output 
the helping text explaining PIP commands and options. 


/UP Update file transfer (equivalent to OPEN AS FILE used 
for output files). 


TParity bits are associated with some ASCII codes, making each ASCII character 
8 bits long rather than 7 bits. The DOS/BATCH Monitor system uses even parity 
ASCII. Even parity implies that the number of bits set within the 8 bit field is 
an even number. 


2Available only with the Record I/O version PIP program. 


by an equal sign (=), followed by the current file specification. The current protection code 


need not be indicated. For example: 
*FILE. EXT <4 > =ABC, DAT 


In this example, the filename, extension, and protection code are changed. The file is stored 


on the system disk, the default device. 
*DT1:MAT, BAC=DT1:ORIG, BAC 


In this example only the filename is changed. The protection code for the file MAT.BAC re~ 


mains the same as it was for ORIG.BAC, 


In the case where only the protection code is to be changed, a new filename specification 


need not be typed. A shorter form is: 


* = old file specification < prot> 
or 


* = old file specification <prot> /RE 


where the /RE (rename) option is assumed if not specified. This command string format indicates 


that the file specification is to be updated. For example: 
* = MAG, BAS <48> 


Notice that the device specification on both sides of the equal sign must be the same. If it is 
desired to move the file from one device to another, the file merge technique (see section 
4.4.2) is used. Note also that PIP assumes a default filename extension of .BAS on input files, 


but an extension must be specified on output files or none is appended. 
4.4.4 File Deletions 


To remove a file from the system, type the file specification followed by the /DE (delete) 


option. For example: 
*TRY2.BAC/DE 


This command string causes the file TRY2.BAC to be removed from the system disk if found under 
the current user's account number. No default assumptions are made as to the filename exten- 


sion. An extension must be specified if the file was stored with an extension. 


The user cannot delete a file under another account or a file which is write-protected 
against him. If an attempt is made to delete a non-existent file from a device, the error mes- 


sage CAN'T FIND FILE OR ACCOUNT is given. 


More than one file can be deleted by specifying several file specifications, separated 


by commas. For example: 
*FILET.BAC, FILE2.BAC, DT 1:FILE1.BAC/DE 


deletes FILEI.BAC from both the system disk and DECtape unit 1 and deletes FILE2.BAC from 
the system disk. The number of files which can be deleted in one PIP command string is limited 


only by the maximum length of the command line. 


4.4.5 Zero Device Directory 


Zeroing a device directory removes all files stored under one account number on the 
given device. In order to perform this operation, log in to the system under that account num- 
ber (with the correct password) and run PIP, giving the device specification followed by the 


/ZE (zero) option: 


RUNS PIP 
PIP RSTS V4A-11 SYSTEM #213 
* /ZE 


This command removes all files stored on the system disk for the current account number. 


*DTI: /ZE 


removes all files on the tape reel mounted on DECtape unit 1. (No file protection is available 


for files on DECtape reels; hence, any user can zero any DECtape reel.) 


4.4.6 List Device Directory 


The user can request a listing of all files under his account number, all files with a given 
name or extension under his account number, or a particular file under his account number on 
the system disk or any one or more devices. The format of the directory listing command is as 


follows: 


*output<input file(s) /option 


4-16 


An output file specification can be supplied where an output device other than the user terminal 


is desired, The more usual form of the command is: 
*input file(s) / option 


in which case the directory listing is sent to the terminal issuing the command. Unless another 


device is specified, only a directory of the system disk is printed. For example: 


RUN$ PIP 
PIP_RSTS_V4A-11 SYSTEM #213 


*, DT@:, DTI:/DI 


will cause a full directory listing of files for the current user on the system disk (The blank 
device specification, indicated by the comma with no preceding characters indicates the 


system disk), and on DECtape units % and 1. 


The options available with device listings are described in Table 4-7.- The input file 


specifications are described in Table 4-8. 


Table 4-7 
PIP Directory Listing Options 


Option Function 


BRief directory listing is printed; includes only filenames and 
extensions with four file specifications on each printed line. 


Normal Directory listing is printed; includes filename, exten- 
sion, length, protection code, and creation date. 


Full (Slow) directory listing is printed; includes: 

a. for disk devices: filename, extension, length, protection 
code, creation date and time. 

b. for magtape or DECtape: filename, extension, length, 
protection code, creation date. 


Table 4-8 


Input File Specifications 


Input File Directory Printed Includes 


none all files on the system disk under the current user account 
number . 


all files under the current user account number on the 
device specified . 


dev: 


dev:* .* same as the above. 


dev:filename.* all files having the filename specified, under the current 
user account number, on the device specified. 


dev:name. ext only the file specified, under the current user account 
number, on the device specified. 


Where no device is specified, the default device is the system disk; no message is 
printed if the particular input file specification(s) cannot be found; where several 
input file specifications are given, they are separated by commas. Account num- 
bers are only significant for disk files. 


Sample directory listing specifications are shown below: 


* * BAC/DI:S 
* $/DI 


4.5 TTYSET PROGRAM 


The TTYSET system program is used to establish terminal characteristics for the user ter- 
minal, TTYSET can be run by any user before or after he is logged into the system. If the ter~ 
minal is not logged into the system, only one command can be entered to the TTYSET program 


at a time in the following format: 
SET xxxx 


where xxxx represents one of the TTYSET commands shown in Table 4-9 and is entered with 


the RETURN or ESCAPE key. If the user is logged into the system, he can run TTYSET as follows: 


RUN$ TTYSET 
‘TTYSET' TERMINAL CHARACTERISTICS PROGRAM 


? XXXX 


where xxxx is again one of the TTYSET commands shown in Table 4-9. When xxxx has been 
entered to the system with the RETURN or ESCAPE key, TTYSET again prints ? to accept 
additional commands. To return control to the RSTS-11 Monitor, type EXIT, CTRL/C, or 
CTRL/Z. 


Command 
EXIT 


HELP 


TAB 


NO TAB 


FORM 


NO FORM 


LC 


NO LC 


XON 

NO XON 
ECHO 

NO ECHO 


SCOPE 


NO SCOPE 


ESC 


NO ESC 


WIDTH n 


SPEED n 


Table 4-9 
TTYSET Commands 


Standard 


Function Condition 


Exit from the TTYSET program; return control to RSTS-11 Monitor. 
Print a description of the other TTYSET commands. 


Enable hardware tab control by the terminal (significant for 
ASR-35 Teletypes). 


Disable hardware tab control by the terminal (significant for 
ASR-33 Teletypes) . 


Enable hardware form feed control by the terminal (significant 
for ASR=35 Teletypes) . 


Disable hardware form feed control by the terminal (significant 
for ASR-33 Teletypes). 


Enable sending of lower case letters (useful with some terminals, 
ignored by others.) 


Translate all lower case letters sent by the terminal into upper 
case letters. 


Enable XON/XOFF remote low-speed reader control. 

Disable XON/XOFF remote low-speed reader control. 

Enable terminal echo facility; results in full duplex mode operation. 
Disable terminal echo facility; results in half duplex mode operation. 


Enable terminal CRT cursor controls (only significant when 
issued from a CRT display terminal). 


Disable terminal CRT cursor controls , 


Treat only ASCII $33 (octal) code as ESCAPE (ESCAPE or 
ALT MODE key). 


Treat ASCII 033, 175, 176 (octal) as ESCAPE (ESCAPE or ALT Set 
MODE key). r 


Set the terminal form width to n characters where 1<n<254(octal). WIDTH 72 


Set DCI1baud rate to DC11speed n where P<n<3 (the actual baud SPEED ) 
rate corresponding to n is dependent upon the particular DCT] 
referenced. 


Table 4-9 
TTYSET Commands (cont'd.) 


Standard 
Command Function Condition 


Set fill factor of n, which is multiplied by the default fill 


factor (see Appendix B of the RSTS-11 System Manager's 
Guide). 


NO FILL Set fill factor of 8, 


FILL LA36 Set special LA3Q serial (DECwriter) fill factor. 


Treat terminal as though it were the indicated device. 
These commands automatically select, from the preceeding 
commands, those features applicable to the respective terminal. 
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4.6 QUOLST PROGRAM 


The QUOLST system program allows the user to determine what portion of his disk quota 
is currently occupied and the number of free blocks remaining on the system disk. QUOLST is 


called as follows: 
RUN$ QUOLST 


Output from QUOLST includes the user account number and information printed under the 


following headings: 


Table 4-10 
QUOLST Column Headings 


Column Heading Meaning 


STR STRucture, device being reported . 

USED number of used 256-word blocks under the user account. 

FREE number of free blocks remaining in the user account disk quota. 

SYSTEM number of free blocks remaining to the system on the structure 
indicated . 


Output f rom QUOLST looks as follows: 
RUN $QUOLST 


USER: [i@@,160] 

STR USED FREE SYSTEM 
DF: 55 145 1234 
DK: 1 1992 1992 


In this example, the user is logged into the system under account [186,188] and has 
used 55 blocks on the system disk(s) with a quota of 268 blocks (280 -55=145 free blocks). 
There are 1234 free blocks on the system disk(s). User [19,180] also has access to private 
disk DK1: He has used 18 blocks on DK: and has no disk quota on that device; therefore, 


the free user block count is equal to the free system block count (1992 blocks). 


4.7 MONEY PROGRAM 


MONEY is the RSTS-11 system accounting program which allows a user to obtain printed 
data on his own account status. The program is called as follows (only by a user logged into 


the system) : 


RUN$ MONEY 


The following shows Teletype output resulting when a user logged into the system under 
account [100, 100] runs the program MONEY: 


FUN? MONEY 


ACGT PASSWORD CPU-TIME KCT'S CONNECT DEVICE ACCESS bpTsx eCvoTse 
16s 1EG 57-5 2578 24:33 g 8 7 SBE kel 53) 


REATY 


2 


CHAPTER 5 


RSTS-11 PERIPHERAL DEVICES 


RSTS-11 has several peripherals which are available to the user. These devices include: 


user terminals (ASR-33, ASR-35, DECwriter, VT@5 display) 
high-speed paper tape reader/punch 

card reader 

line printer 

DECtape 

magtape 


While normal operation of a computer system is by programmed control, manual operation is 
necessary for some tasks. This Chapter describes the manual control and operation of the 
common RSTS-11 user peripherals. Chapter 12 in the BASIC-PLUS Language Manual describes 
device usage for the transfer of information between peripheral equipment and the BASIC- 


PLUS program. 
5.1 ASR-33 Teletype 


The ASR-33 Teletype is an inexpensive, commonly employed user terminal. 


Major features are noted in Figure 5-1. 


OFF 
Line C) LocaL 


Figure 5-1 ASR-33 Teletype Console 
The components of the Teletype unit and their functions are described on the following page. 
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5.1.1 Control Knob 


The control knok of the ASR-33 Teletype console has three positions: 


LINE The console has power and is connected to the system as an I/O device 
under RSTS-11 control. 

OFF The console does not have power. 

LOCAL The console has power for off-line operation under control of the 


keyboard and switches only. 


5.1.2 Keyboard 


The Teletype keyboard shown in Figure 5-2 is similar to a typewriter keyboard, except 
that some nonprinting characters are included as upper case elements. For typing characters or 
symbols such as $, %, or *# which appear on the upper portion of numeric keys and some alpha- 


betic keys, the SHIFT key is depressed while the desired key is typed. 


Nonprinting operational functions are shown on the upper part of some alphabetic keys. 
By depressing the CTRL (control) key and typing the desired key, these functions are activated. 
Use of these CTRL/key combinations are described in Chapter 3 of this manual. l 


OWDDODODDOODOOOO® 
®©OOGOOOOOOOO@® 
OOOOODGOOOGOOC®8 


~) ODOOOOOOOO® 


Figure 5-2 Teletype Keyboard 


Talthough not shown on most keyboards, SHIFT/L produces the backslash character (\) and 
SHIFT/K and SHIFT/M produce the square brackets [and], respectively. 
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5.1.3 Printer 


The Teletype printer provides a printed copy of input and output at ten characters per 
second, maximum rate. When the Teletype unit is on-line to the system (control knob turned 
to LINE), the copy is generated by the computer (even the echoing of the characters typed 
by the user); when the Teletype unit is off-line (control knob tured to LOCAL), the copy is 


generated directly from the keyboard onto the printer as a key is struck. 


5.1.4 Low-Speed Paper Tape Reader 


The paper tape reader is used to read data punched on eight-channel perforated paper 
tape at a rate of 18 characters per second, maximum. The reader controls are ‘shown in Figure 


5-1 and described below. 


START The reader is activated; reader sprocket wheel is engaged and operative. 

STOP The reader is deactivated; reader sprocket wheel is engaged but not 
operative. 

FREE The reader is deactivated; reader sprocket wheel is disengaged. 


The following procedure describes how to properly position paper tape in the low-speed 


reader, 


a. Raise the tape retainer cover. 
b. Set reader control to FREE. 


c. Position the leader portion of the tape over the read pins with the sprocket 
(feed) holes over the sprocket (feed) wheel and with the arrow on the tape 
(printed or cut) pointing outward (forward). 


d. Close the tape retainer cover. 


e. Make sure that the tape moves freely (if the tape does not move back and 
forth freely, the paper feed holes are not properly positioned). 


f. Set reader control to START, and the tape is ready. 


5.1.5 Low-Speed Paper Tape Punch 


The paper tape punch is used to perforate eight-channel rolled oiled paper tape at a max- 
imum rate of 1@ characters per second. The punch controls are shown in Figure 5-1 and 


described on the following page. 


RELease Disengages the tape to allow tape removal or loading. 


B. SP Backspaces the tape one space for each firm depression 
of the B,SP button. 


ON (LOCK ON) Activates the punch, 


OFF (UNLOCK) Deactivates the punch. 
Blank leader/trailer tape is generated by: 


Turning the control knob to LOCAL. 


ao a 
. . 


Turning the punch control to ON. 
Typing the HERE IS key. 
d.  Tuming the punch control to OFF. 


Oo 
. 


e. Turing the control knob to LINE. 
5.2 HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 


One high-speed paper tape unit can be provided with each RSTS-11 system, This unit is 
mounted on the central computer console. A high-speed paper tape unit is pictured in 


Figure 5-3 and descriptions of the reader and punch units follow. 


FEED 


ON LINE 
FEED 


PAPER TAPE OFF LINE 


Figure 5-3 High-Speed Paper Tape Reader/Punch 


5.2.1 High-Speed Reader Unit 


The high-speed paper tape reader is used to read data from eight-channel, fan-folded 
(non-oiled), perforated paper tape photoelectrically at a rate of 368 characters per second, 


maximum. 


NOTE 


Tape from the Teletype punch should not 
be used with the high-speed reader as the 
oil on the tape causes lint and dust to 
collect on the photoelectric cells. 


Primary power is applied to the reader when the computer power is on, 


In order to use the high-speed reader as an input device, turn the reader ON LINE/OFF 
LINE rocker switch to ON LINE. Load tape into the reader as explained below: 


a. Raise the tape retainer cover. 


b. Place tape in right-hand bin with printed arrows pointing toward left-hand bin. 
(Channel one of the tape is toward the rear of the bin.) 


c. Place several folds of blank tape past the reader and into the left-hand bin. 


d. Place the tape over the reader head with feed holes engaged in the teeth of the 
sprocket wheel. 


e. Close the tape retainer cover. 


f. Depress the FEED rocker switch until leader tape is over the reader head. 


The reader is capable of sensing whether a tape is in the reader. If an attempt is made to 


read a tape when the reader is either empty or OFF LINE, an error is generated. 


5.2.2 High-Speed Punch Unit 


The high-speed paper tape punch is used to record computer output on eight-channel , fan- 
folded, non-oiled paper tape at a rate of 5@ characters per second maximum. All characters are 
punched under program control from the computer. Blank tape (feed holes only, no data), is 
produced by pressing the punch FEED rocker switch. The punch unit has power turned on when- 


ever the computer has power; it does not require any additional on/off switch. 


Fan-folded paper tape is generally grey in color. When a box of tape is nearly empty, 
purple tape is produced. Rather than risk running out of tape while punching, replace the box 


of paper tape at this point or notify the system manager who will replace the tape. 


5.3 CR11 CARD READER 


The CR11 card reader allows the RSTS-11 system to accept information from punched 89 
column data cards. Cards can be read under program control at rates of up to 288 or 306 cards 


per minute. 


Power to the reader, shown in Figure 5-4, is controlled by the ON/OFF switch on the 
upper left hand corner of the back panel. Two toggle switches are present on the back panel 
and should be set to AUTO and REMOTE for proper operation, The LAMP TEST button on the 
reader back panel can be depressed to check the operation of the various reader lights on the 


front panel. 
In order to use the card reader: 


a. Remove card weight from input hopper. Place cards loosely in input hopper. The 
first card to be read is placed at the front of the deck, "9" edge down, column 1 
to the left. Replace card weight on top of cards in input hopper. Cards should not 
be packed tightly. 


b. Press green RESET button. Wait 4 seconds for RESET light to come on. The card 
deck is now able to be read under program control. 


c. Cards may be loaded while the reader is operating provided tension is maintained on 
the front of the deck as cards are added to the rear. Additional cards should not be 
loaded until the hopper is 1/2 to 2/3 empty. 


d, The output stacker bin can be unloaded while cards are being read. Care should be 
taken to maintain the order of the deck. 


The various lights and switches (buttons) on the reader front panel and their significance are 
described in Table 5-1. 


Table 5-1 
Card Reader Controls 


POWER light indicates that there is power to the reader. 


READ CHECK light indicates a reading error, torn card, or card too long for reader. 
Reader stops and RESET light is out. 


PICK CHECK light indicates inability to remove card from input hopper. Reader stops 
and RESET light is out. 


STACK CHECK light indicates inability to remove card from input hopper. Reader stops 
and RESET light is out. 


Table 5-1 (cont'd.) 


Light/Switch Function 


HOPPER CHECK light indicates that there are no cards in input hopper or the output 
stacker is full. Condition must be manually corrected to allow further 


operation. 


button, when depressed, causes red light to go on momentarily. RESET 
light goes out and reader operation stops as soon as the card currently 
in the read station has been read. 


button, when depressed, causes green RESET light to go on and initial- 
izes card reader logic. 


Figure 5-4 
CR11 Punched Card Reader 


5.4 LPI1 LINE PRINTER 


The LP11 line printer, pictured in Figure 5-5, has an 88 column capacity, prints ata 
rate of 356 lines per minute at a full 88 columns, and can print 1196 lines per minute at 20 
columns. These rates are based on a 64-character set. A 95-character set and 132-column 
version are also available. The print rate is dependent upon the data and number of columns to 


be printed. 
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Characters are loaded into a 26-character printer memory via a Line Printer Buffer. 
When this buffer is full, the characters are automatically printed. This process continues until 
the 80 columns (four print zones) have been printed or a carriage return, line feed, or form feed 
character is recognized. The printer responds only to codes representing the character set and 


three control characters. All other codes are ignored. 


Figure 5-5 
LP11 Line Printer System (8@-column model) 


5.4.1 Line Printer Character Set 


The 64 character set consists of the 26 upper case letters (A - Z), ten numerals (0 - 9), 
and the space character. The 96-character set contains all of the above plus 26 lower case 


letters and 6 additional symbols. The character codes are 7-bit ANSCII. 
Characters are printed 1@ characters per inch and 6 lines per inch. 


Line printers can use paper varying in width from 4 inches to 9-7/8 inches for the 88-column 


printer. Forms making up to six copies can be used when multiple copy printing is desired. 


The special symbols available are as follows: 


64-character set 96-character set 

1" #$%e&' () all of the 64-character 
* po Sa pais set symbols 

See at a Se ee DEL 


ASCII numeric equivalents for the various characters are contained in Appendix D. 


5.4.2 Line Printer Operation 


Figure 5-6 illustrates the line printer control panel on which are mounted three 
indicator lights and three toggle switches. Operation of these switches and the power switch, 


and the meaning of the lights is explained in Table 5-2. 


ON LINE 


© © @ 


TOP PAPER OFF LINE 
OF STEP 
FORM 


Figure 5-6 Line Printer Control Panel 


Table 5-2 


Line Printer Controls 


Light/Switch Function 


POWER light Glows red to indicate main power switch (located inside cabinet) 
is at ON position and power is available to the printer. 


READY light Glows white, shortly after the POWER light goes on to indicate 
that internal components have reached synchronous state , paper 
is loaded, and the printer is ready to operate. 


ON LINE fight Glows white to indicate that ON LINE/OFF LINE toggle 
switch is in ON LINE position. 
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ON LINE/OFF LINE switch 


TOP OF FORM switch 


PAPER STEP switch 


ON/OFF (main power) switch 


Table 5 - 2 (cont'd.) 


This three-position toggle switch is spring-returned to center. 
When momentarily positioned at ON LINE it logically connects 
the printer to the computer and causes the ON LINE light to 
glow. Positioned momentarily at OFF LINE, the logical con- 
nection to the computer is broken, the ON LINE light goes off, 
and the TOP OF FORM aad PAPER STEP switches are enabled. 

If printer is switched to OFF LINE, the ON LINE light remains 
on until either PAPER STEP or TOP OF FORM switch is activated, 
The printer should again be turned ON LINE, 


This two-position toggle switch is tipped toward the rear of the 
cabinet to roll the form to the top of the succeeding page. It 

is spring-+teturned to center position, and produces a single top- 
of-form operation each time it is actuated. The switch is effec- 
tive when the printer is off line. 


This two-position toggle switch operates similarly to TOP OF 
FORM but produces a single line step each time it is actuated, 
It is only effective when the printer is off line. 


This switch controls line current to the printer. To gain access 
to it, the printer front panel is unlatched, by pushing the 
circular button on the right hand edge, and opened to the left 
on its hinges. The switch is located to the left of center approx- 
imately fourteen inches below the top. If power is available, 
the red POWER light on the control panel will glow when the 
switch is positioned at ON. 


The switch is on when in the up position. The ON and OFF 
labels are printed on the stem of the switch. A group of two 
switches and three indicator lights, above the main power 
switch, are for the use of technicians in making initial adjust- 
ments to the printer. 


The following procedure is used when loading paper in the line printer. 


a. Open front door of cabinet. POWER light should be on. Printer should be off line. 


b. Lift control panel TOP OF FORM switch and release to move tractors to correct 


loading position. 


c. Open drum gate by moving drum gate latch knob to left and up. Swing drum gate 


open, 


d. Adjust right hand tractor paper width adjustment for proper paper width if necessary. 
(Loosen set screw on 88 column printer; user release mechanism on 132 column 
printer.) Tighten tractor after adjustment. 


e. Open spring loaded pressure plates on both tractors. 
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f. Load paper so that the two red arrows point to a perforation. Paper should lie 
smoothly between tractors without wrinkling or tearing the feed holes. 


g. Close spring-loaded pressure plates on both tractors. 


h. Adjust COPIES CONTROL lever to proper number of copies to be made, if necessary, 
Set to 1 or 2 for single forms, set to 5 or 6 for six-part forms. 


i. Close drum gate and lock in position with drum gate latch. After 18 seconds the 
READY indicator should light. 


j. Lift TOP OF FORM switch several times to ensure paper is feeding properly. 
k. Set printer to on line. ON LINE indicator should light. At this point printed 


matter can be aligned with the paper lines, if desired, by rotating the paper 
vertical adjustment knob. 


DECtape units are available on most RSTS-11 systems. DECtape serves as an auxiliary 


magnetic tape storage facility to the system disk(s). 
A DECtape peripheral unit consists of three components: 


a. TU5S DECtape transport, pictured in Figure 5-7, which reads and/or writes infor- 
mation on magnetic tape. 


b. TCI1 Controller, the interface which controls information transfer. One controller 
serves up to four transports (up to 8 tapedrives). The Controller is transparent to 


the RSTS-11 user. 


c. DECtape , the recording medium used for data storage, consists of reel mounted 
magnetic tape formatted to permit read/write operations in either direction, error 
checking, block identification, and timing control. 


Figure 5-7 TU56 DECtape Transport 
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DECtape stores and retrieves information at fixed positions on magnetic tape. The advan- 
tage of DECtape over conventional magnetic tape is that information at fixed positions can be 
addressed. Conventional magnetic tape stores information in sequential (not addressable direct- 
ly), variable-length positions. DECtape incorporates timing and mark information to reference 
the fixed positions. The ten-channel DECtape records five channels of information: a timing 
channel, a mark channel, and three information channels. These five channels are duplicated 
on the five channels remaining to minimize any possibility of information loss from the other 


channels. 


Each formatted (certified) DECtape contains 578 blocks of data consisting of 256 (16-bit) 
PDP-11 words per block. 562 blocks are available to the user on each DECtape (several blocks 


are used for file directories) . 


Tape movement can be controlled by programmed instructions from the computer (i.e., 
through PIP) or by manual operation of switches located on the front panel of the transport. 
Data is transferred only under program control. The transport controls and lights are described 
in Table 5-3. 


Table 5-3 
DECtape Controls 


REMOTE/OFF/LOCAL This three-position rocker switch determines control of the 
DECtape unit. 


REMOTE enables computer control of the transport unit. 
OFF disables the transport unit. 


LOCAL places the transport unit under operator control 
from the external transport switches. 


FORWARD/REVERSE This two-position rocker switch enables manual winding of tape 
when transport unit is under LOCAL control. 


FORWARD causes tape to feed onto right-hard spool. 


REVERSE causes tape to feed onto left-hand spool. 


Unit selector The value specified by this eight-position rotary switch identi- 
fies the trarsport to the computer. A unit selecto~ value of 1 
allows the tape on that unit to be accessed as device DTI: 
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Tale 5-3 (cont'd.) 
Light/Switch Function 


WRITE ENABLE/WRITE LOCK _ This two-position rocker switch determines whether o> not a 
taps can be written. Any tape can be searched and read; 
however when the WRITE LOCK switch is on, the tape is 
protected from accidental writing or program deletion. 


REMOTE light When lit, the tape unit is on-line. The tape unit is on-line 
when: 


a. REMOTE/OFF/LOCAL switch is in REMOTE position, and 


b. unit selector switch setting agrees with the DECtape unit 
currently being accessed. 


WRITE ENABLE light When lit, indicates that the WRITE ENABLE/WRITE LOCK switch 
is set to WRITE ENABLE, regardless of whether the REMOTE 
light is on or not. 


Operating procedures associated with DECtape units are described below. In order to 


mount a tape on a DECtape drive: 


a. Set the REMOTE/OFF/LOCAL switch to OFF. 


b. Place full DECtape reel on left spindle with label facing out. Press reel 
tightly onto spindle. 


c. Pull tape leader over the two tape guides and the magnetic head until it 
reaches the take-up reel on the right hand side of the tape unit. 


d. | Wind loose tape end four turns around the empty right-hand reel by rotating 
right reel clockwise. 


e. Set REMOTE/OFF/LOCAL switch to LOCAL. Verify that power is available 
to the tape unit. 


f. Depress FORWARD/REVERSE switch in the FORWARD direction to wind about 
15 turns onto the right-hand reel. This ensures that the tape is securely 
mounted. 


In order to operate the DECtape unit on-line: 


a. Set the REMOTE/OFF/LOCAL switch to either LOCAL or OFF and be sure 


power is available to the system. 
b. Load the appropriate DECtape following the instructions above. 
c. — If the DECtape write operation is to be inhibited (to protect tape from acci- 


dental damage), set WRITE ENABLE/WRITE LOCK switch to WRITE LOCK. 
If the write operation is desired on this tape, set switch to WRITE ENABLE, 
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Dial the correct unit number on the unit selector. (No two active DECtape 
units should have the same unit number.) 


Set REMOTE/OFF/LOCAL switch to REMOTE. Use of this DECtape unit is 


now under program control. 


When on-line operation of this unit is to cease, set REMOTE/OFF/ 

LOCAL switch to OFF or LOCAL. A moving tape can be stopped by quickly 
switching the REMOTE/OFF/LOCAL switch from REMOTE to LOCAL, The 
switch can be set to OFF when tape motion has stopped. 


To remove a DECtape from the tape unit: 


Set REMOTE/OFF/LOCAL switch to LOCAL, 


Depress and hold REVERSE switch until all tape is wound onto the left-hand 
tape reel. 


Set REMOTE/OFF/LOCAL switch to OFF. 


Remove full reel from left-hand spindle. 


5.6 TMII/TUIO MAGTAPE CONTROL AND TRANSPORT 


Magtape is an optional addition to a RSTS-11 system. Magtape is used to provide storage 


for large volumes of data and programs. Writing, reading, and search operations are performed 


in a serial manner. Transfer of information can be made between RSTS-11 and other computer 


systems because the TU10 Controller reads and writes information in an industry-compatible 


format. 


The basic DECmagtape system consists of three components: 


TU10 Tape Transport, pictured in Figure 5-8, can read or write information 
on magnetic tape in nine channels (on RSTS-11, with a choice of 7 or 9 
channels in other applications). 


TMI11 Controller is an interface between the tape transport units and the 
RSTS~11 system (unibus). One Controller serves up to eight transport units. 
The Controller is transparent to the RSTS-11 user. 


Magnetic Tape, the recording medium used for data storage, consists of reel- 
mounted magnetic tape formatted in 9-channel industry-compatible format. 
Tape includes end-of-tape (EOT) and beginning-of-tape (BOT) reflective 
(silver) markers, record gaps, lateral and longitudinal parity characters, and 
file marks, with a cyclic redundancy check character. 
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Figure 5-8 TUI0 DEC Magnetic Tape System 


Transfer rate is up to 36,00 characters per second. Ten and one half inch magtape reels 
permit up to 2400 feet of tape per reel. Rewind time for a reel of 2400 feet is approximately 


3 minutes, end to end. 


5.6.1 Magtape Control Panel 


The TUIO magtape transport control panel is shown in Figure 5-9. This panel is located 
at the lower left of the TU10 front panel shown in Figure 5-8. Table 5-4 describes the fape 


transport controls and Table 5-5 describes the various tape transport indicators. 


OFF 


PWR_ON ‘ON-LINE START 


PWR OFF OFF-LINE 
LOAD 


cP-0093 


Figure 5-9 TUI£ Control Panel 
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PWRON/ PWR OFF 
ON-LINE/OFF-LINE 


START/STOP 


LOAD/BR REL 


UNIT SELECT 


FWD/REW/REV 


PWR light 
(power) 


LOAD light 


RDY light 
(ready) 


LD PT light 
(load point) 


END PT light 
(end point) 


Table 5-4 
Magtape Transport Controls 


This two~position switch applies power to the transport unit. 


This two-position switch controls operation of the transport unit. 
ON-LINE allows system operation under program control. OFF- 
LINE allows manual operation. Tape unit cannot be remotely 
selected when switch is in OFF-LINE position. Setting to OFF- 
LINE causes tape to wind to BOT marker. 


This two-position switch controls starting and stopping of tape 
motion. STOP does not stop transport during a rewind operation. 


This three-position switch energizes the vacuum system in the 
LOAD position (necessary for any operation). The BR REL posi- 
tion releases vacuum tension and allows reels to be manually 
rotated. Center position locks reel brakes. 


This eight-position rotary switch identifies the transport to the 
computer. A unit select value of | allows the tape on that unit 
to be accessed as device MT1: No two transports should be set 
to the same number. 


This three-position switch moves the tape in the selected direc- 
tion, depending on activation of the START/STOP switch. FWD 
moves tape forward until EOT marker is sensed. REW rewinds 
tape onto the feed reel until BOT marker is sensed; depressing the 
switch again causes the tape to completely rewind. REV rewinds 
tape until BOT marker is sensed. 


Table 5-5 


Magtape Transport Indicators 


When lit, indicates that power is available to the transport unit. 


When lit, indicates that vacuum system has been enabled, 
allowing either on-line or off-line commands. 


When lit, indicates that all I/O lines are enabled. Transport 
can accept processor commands provided SEL light is also lit. 


When lit, indicates that BOT marker has been sensed; transport 
ready for operation. 


When lit, indicates that EOT marker has been sensed; all tape 
motion stops to prevent tape from winding off reel. 


FILE PROT light 
(file protection) 


OFF-LINE light 
SEL light 


(select) 


WRT light 


(write) 


FWD light 
(forward), 


REV light 


(reverse) 


REW light 
(rewind) 


Table 5-5 (cont'd.) 
Function 
When lit, indicates that writing on the tape is inhibited. This 
is true if no file reel is mounted on feed reel hub or if a file 


reel is mounted without a write enable ring. 


When lit, indicates that transport can be operated manually 
and cannot be operated under program control. 


When lit, indicates that transport has been selected and is 
completely on-line. Transport can read or write data. 


When lit, indicates that write-enable ring has been installed 
on feed reel and transport can write on tape. 


When lit, indicates tape is moving in forward direction. 


When lit, indicates that tape is moving in reverse direction. 


When lit, indicates that tape is being rewound; Tape continues 
until BOT marker is sensed. 


5.6.2 Magtape Operating Procedures 


Whenever handling magnetic tapes and reels, it is important to observe the following 


precautions to prevent loss of data and/or damage to tape handling equipment: 


Handle a tape reel by the hub hole only. Squeezing reel flanges can damage 
tape edges when winding or unwinding tape. 


Never touch tape between BOT and EOT markers. Do not allow end of tape 
to drag on floor. 


Never use a contaminated reel of tape; this spreads dirt to clean tape reels 
and can affect transport operation. 


Always store tape reels inside containers. Keep empty containers closed so 
dust and dirt cannot collect. 


Inspect tapes, reels, and containers for dust and dirt. Replace old or 
damaged take-up reels. 


Do not smoke near transport or tape storage area. Smoke and ash are 
especially damaging to tape. 


g. Do not place transport near a line printer or other device that produces 
paper dust. 


h. Clean tape path frequently. 
To mount a tape reel on the magtape transport: 


a. Apply power to the transport by depressing the PWR ON switch. Ensure 
that the LOAD/BR REL switch is in the center position. Transport is ON- 
LINE. 


b. Place a write-enable ring in the groove on the file reel if data is to be 
written on the tape. !f writing is not required, be sure there is no ring 
in the groove. 


c. Mount file reel onto lower hub with groove facing toward the back. Press 
reel tightly onto spindle; tighten center nut. 


d. Install take-up reel (top reel), if necessary, as described in (c) above. The 
top reel is generally permanent and should not require installation by the user. 


e. Place LOAD/BR REL switch to the BR REL position. 


f. Unwind tape from the file reel and thread tape over tape guides and head 
assembly as shownin Figure 5-8. Wind abcut five turns of tape onto 
take-up reel. 


g.- Set LOAD/BR REL switch to LOAD position to draw tape into vacuum 
columns. 


h. Select FWD and depress the START switch to advance the tape to the load 
point. When BOT marker is sensed, tape motion stops, the FWD indicator 
goes out and the LOAD PT indicator comes on. 


If tape motion continues for more than 1M seconds, depress STOP, select 
REV, and then depress START. The tape will advance to the BOT marker 
before stopping. (This may be necessary if, in winding the tape manually, 
the BOT marker has already been passed.) 


Setting the ON-LINE/OFF-LINE switch to ON-LINE allows the transport to accept commands 
from the controller under program control. The transport is not fully on-line until the RDY and 


SEL indicators are lit. 
To remove a tape from the transport unit: 


a. Set ON-LINE/OFF-LINE switch to OFF-LINE position. 
b. Set START/STOP switch to STOP position. 
c. Set FWD/REW/REV switch to REW position. 
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Set START/STOP switch to START position Tape rewinds until BOT 
marker is reached. 


Set LOAD/BR REL switch to BR REL position to release brakes. 


Gently hand wind the file reel in a counter clockwise direction until all of 
the tape is wound onto the reel. Do not jerk the reel. This may stretch or 
compress the tape which can damage data. 


Remove the file reel from the hub assembly. 
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APPENDIX A 
BASIC-PLUS LANGUAGE SUMMARY 


All manual section numbers given in this Appendix 


The BASIC-PLUS Language Manual. 


A.1 SUMMARY OF VARIABLE TYPES 


Type 
Floating Point 


Integer 
Character String 


Floating Point 
Matrix 


Integer Matrix 


Character String 
Matrix 


Variable Name 


single letter 
optionally followed by a 
single digit 


any floating point variable 
name followed by a % character 


any floating point variable 
name followed by a $ character 


any floating point variable 
name followed by one or two 
dimension elements in 
parentheses 


any integer variable name 
followed by one or two dimen- 
sion elements in parentheses 


any character string variable 
name followed by one or two 
dimension elements in paren- 
theses 


A.2 SUMMARY OF OPERATORS 


Type 
Arithmetic 


Relational 


Logical 


String 


Matrix 


Operator 


- unary minus 

+ exponentiation 

*,/ multiplication, division 
+,- addition, subtraction 


equals 
less than 


< 
<= less than or equal to 
> 


greater than 
>= greater than or equal to 
<> not equal to 
== approximately equal to 


NOT logical negation 

AND logical product 

OR logical sum 

XOR logical exclusive or 
IMP logical implication 

EQV logical equivalence 


+ concatenation 


+,- addition and subtraction 


of matrices of equal dimen- 


sions, one operator per 


statement 

* multiplication of con- 
formable matrices 

* scalar multiplication of 
a matrix 


A-1 


refer to sections in 


S (4) E(5,1) 
V8 (3,3) 


I3 (3,5) 
E3%(4) R2%(2,1) 


S$ (8,5) 
A2$ (8) V1$ (4,2) 


Operates Upon 


numeric variables 
and constants 


string or 
numeric variables 
and constants 


== undefined 
for strings 


relational ex- 
pressions composed 
of string or 
numeric elements 
with relational 
operators 


string constants 
and variables 


dimensioned vari- 
ables. See Sec- 
tion 7.6.1 for 
further details. 


A.3 SUMMARY OF FUNCTIONS 


Under the Function column, the function is shown as: 


Y=function 


where the characters % and $ are appended to Y if the value returned 
is an integer or character string. 


A floating value (X), where specified, can always be replaced 
by an integer value. An integer value (N%) can always be replaced 
by a floating value (an implied FIX is done) except in the CVT&S 
and MAGTAPE functions (the symbol I% is used to indicate the neces- 
sity for an integer value). 


Section numbers found in the Explanation column refer to sections 


in the BASIC-PLUS Language Manual. 


Type Function Explanation 
Mathematical Y=ABS (X) returns the absolute value of X, 
Y=ATN (X) returns the arctangent of X in radians. 
Y=COS (X) returns the cosine of X in radians, 
Y=EXP (X) returns the value of etx, where e=2.71828, 
Y=FIX (X) returns the truncated value of X, 
SGN (X) * INT (ABS (X) ) 
Y=INT (X) returns the greatest integer in X which 
is less than or equal to X. 
Y=LOG (X) returns the natural logarithm of X, log,X. 
Y=LOG1Q (X) returns the common logarithm of X, 10g 9X: 
Y=PI has a constant value of 3.14159. 
Y=RND returns a random number between g andl, 
Y=RND (X) returns a random number between @ andl, 
Y=SGN (X) returns the sign function of X, a value 
of 1 preceded by the sign of X, 
Y=SIN (X) returns the sine of X in radians. 
Y=SQR (X) returns the square root of X. 
Y=TAN (X) returns the tangent of X in radians. 
Print Y%=POS (X%) returns the current position of the print 


head for I/O channel X, @ is the user's 
Teletype. (This value is imaginary for 
disk files.) 

YS=TAB (X3%) moves print head to position X in the cur- 
rent print record, or is disregarded if 
the current position is beyond X. The 
first position is counted as £.) 


String Y%=ASCII (A$) returns the ASCII value of the first char- 
acter in the string AS. 
YS=CHRS (X%) returns a character string having the 


ASCII value of X. Only one character 
is generated. 

YS=CVTSS (1%) maps integer into 2-character string, see 
Section 11.5. 

YS=CVTFS (X) maps floating-point number into 4- or 8- 
character string, see Section 11.5. 

Y%=CVT$3 (AS) maps first 2 characters of string A$ into 
an integer, see Section 11.5. 


Y=CVTSF (A$) maps first 4 or 8 characters of string A$ 
into a floating-point number. See Sec- 
tion 11.5. 
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Type Function Explanation 


Strings Y$=LEFT (AS ,N%) returns a substring of the string AS 
cont'd, from the first character to the Nth 
character (the leftmost N characters). 
YS=RIGHT (A$ ,N%) returns a substring of the string A$ 


from the Nth to the last character; 
the rightmost characters of the string 
starting with the Nth character. 
Y$=MID(A$,N1%,N2%) returns a substring of the string AS 
starting with the Nl and being N2 
characters long (the characters 
between and including the Nl 
to N1+N2-1 characters). 
Y%=LEN (AS) returns the number of characters in the 
string AS, including trailing blanks. 
Y%=INSTR(N1%,A$,B$) indicates a search for the substring 
BS within the string A$ beginning at 
character position Nl. Returns a 
value @ if BS is not in AS, and the 
character position of B$ if BS is 
found to be in A$ (character posi- 
tion is measured from the start of 
the string). 


YS=SPACES (N$%) indicates a string of N spaces, used 
to insert spaces within a character 
string. 

YS=NUMS (N%) indicates a string of numeric charac- 


ters representing the value of N as 
it would be output by a PRINT state- 
ment. For example: NUMS$(1.999#) 
(space) 1(space) and NUM$(-1. 9969) 
-l(space). 

Y=VAL (A$) computes the numeric value of the 
string of numeric characters AS. 
If A$ contains any character not 
acceptable as numeric input with 
the INPUT statement, an error re- 
sults. For example: 


VAL ("15")=15 


YS=XLATE (AS,BS) translate A$ to the new string YS 
by means of the table string BS, 
see Section 11.7. 


System Y$=DATES (9%) returns the current date in the fol- 
lowing format: 
g§2-Mar-71 
YS$=DATES (N$%) returns a character string correspond- 


to a calendar date as follows: 
N=(day of year)+{ (number of 
years since 1970) *1000] 


DATES (1) = "@1l-Jan-79" 
DATES (248) = "@5-May-79" 
YS$=TIMES (93) returns the current time of day as a 


character string as follows: 
TIMES (9) = "95:39 PM" 
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Type 


Matrix 


Magtape 


Function 


YS=TIMES (N%) 


Y=TIME (9%) 
Y=TIME (18) 


Y=TIME (2%) 


Y%=ERR 


Y%=ERL 


Y%=SWAPS (N3) 


YS=RADS (N%) 


MAT Y=TRN (X) 
MAT Y=INV(X) 


Y=DET 


YS=NUM 


Y%3=NUM2 


Explanation 


returns a string corresponding to the 
time at N minutes before midnight, 
for example: 


TIMES (1) = "11:59 PM" 
TIMES (1449) = "12:99 AM" 
TIMES (721) = "11:59 AM" 


returns the clock time in seconds since 
midnight, as a floating point number. 

returns the central processor time used 
by the current job in tenths of seconds. 

returns the connect time (during which 
the user is logged into the system) 
for the current job in minutes. 

returns value associated with the last 
encountered error if an ON ERROR GOTO 
statement appears in the program. 
See Section 8.4. 

returns the line number at which the 
last error occurred if an ON ERROR 
GOTO statement appears in the pro- 
gram. See Section 8.4.3. 

causes a byte swap operation on the 
two bytes in the integer variable N&%. 

converts an integer value to a 3- 
character string and is used to con- 
vert from Radix-59 format back to 
ASCII. See Appendix D. 


returns the transpose of the matrix X, 
see Section 7.6.2. 

returns the inverse of the matrix X, 
see Section 7.6.2. 

following an INV(X) function evaluation, 
the variable DET is equivalent to the 
determinant of X. 

following input of a matrix, NUM con- 
tains the number of elements entered 
in the last row. 

following input of a matrix, NUM2 con- 
tains the number of rows input. 


Y%=MAGTAPE (11%,12%,13%) 


Y%=RECOUNT 


provides program control over magtape 


operations by means of several func- 
tion specifications. See Section 
12.3.7. 


returns the number of characters read 


following every input operation. 
Used primarily with non-file struc- 
tured devices. See Section 11.3.1. 


A.4 SUMMARY OF BASIC-PLUS STATEMENTS 


The following summary of statements available in the BASIC-PLUS 
language defines the general format for the statement as a line in a 
BASIC program. If more detailed information is needed, the reader is 
referred to the section(s) in the BASIC-PLUS Language Manual dealing 
with that particular statement. 


NOTE: All section numbers -refer to the BASIC-~PLUS Language Manual, 


In these definitions, elements in angle brackets are necessary 
elements of the statement. Elements in square brackets are necessary 
elements of which the statement may contain one. Elements in braces 
are optional elements of the statement. 


Where the term line number ({line number}) is shown in braces, 
this statement can be used in immediate mode. 


The various elements and their abbreviations are described below: 
vartable or var Any legal BASIC variable as described in A.1 


or Section 2.5.2. 


line number Any legal BASIC line number described in 
Section 2.2. 


expression oOYr exp Any legal BASIC expression as described in 
Section 2.5. 


message Any combination of characters. 

condition or cond Any logical condition as described in Sec- 
tion 3.5. 

constant Any acceptable integer constant (need not 


contain a % character). 
argument(s) or arg Dummy variable names. 
statement Any legal BASIC-PLUS statement. 


string Any legal string constant or variable as 
described in Section 5.1. 


proteectton Any legal protection code as described in 
Section 9.1. 


value(s) Any floating point, integer, or character 
string constant. 


list The legal list for that particular statement. 

dimenston(s) One or two dimensions of a matrix, the maxi- 
mum dimension(s) for that particular state- 
ment. 


Statement Formats and Examples 


BASIC-PLUS Language 
Manual Section 


REM 
{line number} REM <message> 3.1 
{line aiee) Ge tabent ao) nese 
1g REM THIS IS A COMMENT 
15 PRINT !PERFORM A CR/LF 
LET 
{line number} {LET}<var>{,<var>,<var>...} = <eup> 3.2 
55 LET A=49: B=22 
68 B,C,A=4.2 I!MULTIPLE ASSIGNMENT 
DIM 
line number DIM<var(dimenstion(s))> 3.6.2 
1¢ DIM A(2f8), BS$(5,18), C%(45) 7.1 
line number DIM #<constant>,<var(dimenston(s))>=<eonstant>9.6.1 
75 DIM #4, AS$(199)=32,B(59,59) 9.6.2 
RANDOMIZE 3.7.2 
Zine number RANDOM{IZE} 
55 RANDOMIZE 
78 RANDOM 
IF-THEN, IF-GOTO THEN<statement> 
Zine mumber IF <eond> [ muen<tin ranber> | 3.5 
GOTO<tline number> 
55 IF A>B OR B>C THEN PRINT "NO" 
69 IF FNA(R)= B THEN 259 
95 IF L<Xt2 AND L<>@ GOTO 345 


IF-THEN-ELSE 


tine number 


FOR 
line number 


2g 
55 


FOR-WHILE, FOR-UNTIL 


line number 


NEXT 
line number 
25 
68 


THEN<s tatement> 8.5 
IF <eond>]| THEN<line number> ELSE<statement> 

GOTO<Zine number> ELSE<line number> 
IF B=A THEN PRINT “EQUAL" ELSE PRINT "NOT EQUAL" 


IF A>N THEN 299 ELSE PRINT A 
IF B==R THEN STOP ELSE 89% 


FOR <var>= <exp>TO <exp> {STEP<exp>} 3.6.1 
FOR I=2 TO 49 STEP 2 
FOR N=A TO A+R 

WHILE Be 
FOR <var> = <exp> (sme cozp>)[ WILE] <ceond> 
FOR I = 1 STEP 3 WHILE I<X 
FOR N = 2 STEP 4 UNTIL N>A OR N=B 
FOR B= 1 UNTIL B>l1g 

3.6.1 

NEXT <var> 
NEXT I 
NEXT N 


Statement Formats and Examples 


DEF, single line 


line number 


DEF, multiple line 


29 


line number 
<statements> 


Line 
line 


GOTO 


line 


ON-GOTO 
line 


GOSUB 
line 


ON-GOSUB 
line 


RETURN 
line 


CHANGE 


{line 


OPEN 


{line 


CLOSE 
line 


READ 
line 


number 
number 


number} 


BASIC-PLUS Language 


Manual Section 


DEF FN<var>(arg) =<exp(arg)> 
DEF FNA(X,Y,2Z)=SQR(X*2+Y¥+2+Z+2) 


DEF FN<var>(arg) 


FN<var>=<exp> 

FNEND 

DEF FNF(M) !FACTORIAL FUNCTION 

IF M=1 THEN FNF=1 ELSE FNF=M*FNF (M-1) 
FNEND 


GOTO <line number> 
GOTO 5¢ 


ON <exp> GOTO <list of line numbers> 
ON X GOTO 95, 159, 45, 299 


GOSUB <ltine number> 
GOSUB 299 


ON <exp> GOSUB <list of line numbers> 
ON FNA(M) GOSUB 299, 259, 499, 375 


RETURN 
RETURN 


CHANGE| <@7"4y Sag 
<string var> 


CHANGE AS TO X 
CHANGE M TO RS 
CHANGE B TO BS 


TO eK var> 
<array name> 


ae) AS FILE <exp> 


te A: 
OPEN string>{For( seer 


{,RECORDSIZE<exp>}{,CLUSTERSIZE <exp>}{,MODE <exp>} 


1g 
29 
39 


number} 


199 
255 


number 
25 


OPEN "PP:" FOR OUTPUT AS FILE Bl 9.6.3 
OPEN "FOO" AS FILE 3 
OPEN "DT4:DATA.TR" FOR INPUT AS FILE 19 


CLOSE <list of exp> 11.2 
CLOSE 2 
CLOSE 19, 


4, Nl 


3 
5 
READ <list of vartables> 6 
READ A, BS, C%, Fl, R2, B(25) 10 


Statement Formats and Examples 


BASIC-PLUS Language 
Manual Section 


DATA 3.361 
line number DATA <ltst of values> 5.3 
398 DATA 4.3, “STRING",85,49,75.94,19 6.3 
RESTORE 3.3.1 
line number RESTORE 10.2 

125 RESTORE 
PRINT 3.3.2 
5.4 
{line number} PRINT{{#<exp>, }<list>} 6.3 
25 PRINT !GENERATES CR/LF 9.2.3 
75 PRINT "BEGINNING OF OUTPUT";1,A*I 9.3 
45 PRINT #4,"OUTPUT TO DEVICE"FNM(A)+2;B;A 10.4 

PRINT USING 

tine number} PRINT {#<exp>, }USING <string>, <list> 10.4 


54 PRINT USING "##.##",A 


55 PRINT #3, USING"\\###.## \\##tttt","A=",A,"B=",B 


56 PRINT #7, USING BS,A,B,C 


INPUT 
Tline number} INPUT {#<exp>, }<list> 
25 INPUT "TYPE YOUR NAME ",AS$ 
55 INPUT #8, A, N, BS 


INPUT LINE 
Tine number} INPUT LINE {#<exp>,} <string> 
4g INPUT LINE RS 
75 INPUT LINE #1, ES 


NAME-AS 
{line number} NAME <string> AS <string> 
455 NAME "NONAME" AS “FILE1<48>" 
278 NAME "DT4:MATRIX" AS "MATA1<48>" 


KILL 
{line number} KILL <string> 
45 KILL "NONAME" 


ON ERROR GOTO 
line number ON ERROR GOTO {<line number>} 
18 ON ERROR GOTO 599 


m O1 WW WW Ww 


ie) 
° 
lo Ww 


525 ON ERROR GOTO !DISABLES ERROR ROUTINE 
526 ON ERROR GOTO @ !DISABLES ERROR ROUTINE 


RESUME 
Zine number RESUME {<line number>} 


1999 RESUME !OR RESUME @ ARE EQUIVALENT 


655 RESUME 299 


CHAIN 


Line number CHAIN <string> {<line number>} 
375 CHAIN "PROG2.BAC" 
588 CHAIN "PROG3.BAC" 75 


BASIC-PLUS Language 


Statement Formats and Examples Manual Section 
STOP 3.9 
line number STOP 
75 STOP 
END 3.9 
line number END 
545 END 


Matrix Statements 


MAT READ 7.2 
line number MAT READ <list of matrices> 
55 DIM A(2¢), BS(32), C%(15,1f) 
99 MAT READ A, B$(25), C% 


MAT PRINT 7.3 
line number} MAT PRINT{#<exp>,} <matrix name> 
1g DIM A(2f), B(15,29) 


99 MAT PRINT A; !PRINT 18*19 MATRIX, PACKED 
95 MAT PRINT B(19,5), !PRINT 1@8*5 MATRIX, FIVE 
!ELEMENTS PER LINE 
97 MAT PRINT #2, A; !PRINT ON OUTPUT CHANNEL 2 
MAT INPUT 7.4 


line number} MAT INPUT{#<exp>,} <list of matrices> 
1g DIM BS(4M), F1%(35) 
28 OPEN "DT3:FOO" FOR INPUT AS FILE 3 
38 MAT INPUT #3, B4, F13 


MAT Initialization 7.5 
ER 
{line number} MAT <matrix name>=|CON|{dimension(s)} 

D 

1f DIM B(15,1f), A(1f), C%(5) 

15 MAT C% = CON !ALL ELEMENTS OF C%(I)=1 

28 MAT B= IDN (18,19) ! IDENTITY MATRIX 1g*1g 

95 MAT B = ZER(N,M) !CLEARS AN N BY M MATRIX 


Statement Modifiers (can be used in immediate mode) 


iF Aa 
<statement> IF <eondttion> 
1g PRINT X IF X<o”g 


UNLESS 
<statement> UNLESS <eondition> 8.7.2 
* 45 PRINT A UNLESS A=9 
FOR 8.7.3 
<statement> FOR <var> = <exp> TO <exp>{STEP<exp>} 
75 LET B$(I) = "PDP-11" FOR I = 1 TO 25 
88 READ A(I) FOR I=2 TO 8 STEP 2 
WHILE 8.7.4 


<statement> WHILE <condition> 
1g LET A(I) = FNX(I) WHILE I<45.5 


Statement Formats and Examples 


UNTIL 


BASIC-PLUS Language 
Manual Section 


<statement> UNTIL <eondttion> 


System statements 


<line 


<Lline 


115 


number> 


122 


number> 
525 


Record I/O Statements 


<line 


<Line 


<line 


<line 


<Lline 


<Line 


number> 


9p 


num ber> 
256 


number> 
75 


number> 


169 


number> 


5D 


num ber> 


762 


8.7.5 
IF B § THEN A(I)=B UNTIL I>5 
SLEEP <expresston> 8.8 
SLEEP (28) !IDISMISS JOB FOR 2 SEC. 
WAIT <expresston> 8.8 
WAIT (A%+5) !IWAIT A%+5 SEC. FOR INPUT 
LSET<string var>{,<string var>}=<string> 11.4.2 
LSET BS="XYZ" 
RSET<string var>{,<string var>}=<string> 11.4.2 


RSET CS$="6789" 


FIELD#$<expr>,<expr>AS<string var>{,<expr>AS<string var>} 


FIELD#2%,18% AS A$, 26% AS BS 11.4.1 
GET#<expr>{,RECORD<expr>} 11.3 
GET#1%,RECORD 99% 
PUT#<expr>{,RECORD<expr>}{,COUNT<expr>} 11.3 
PUT#1%,COUNT 89% 

UNLOCK#<expr> 12.2 
UNLOCK #3% 


APPENDIX B 
BASIC-PLUS COMMAND SUMMARY 


Section in 
RSTS-11 


Command Explanation System User's Guide 


ASSIGN Used to reserve an I/O device for the use of 2.6.3 
the individual issuing the command. The speci- 
fied device can then be given commands only 
from the terminal which issued the ASSIGN. 


BYE Indicates to RSTS that a user wishes to leave 2.1.3 
the terminal. Closes and saves any files re- 
Maining open for that user. 


CAT Returns the user's file directory. Unless an- 20:32 
CATALOG other device is specified following the term 
CAT or CATALOG, the disk is the assumed device. 


COMPILE Allows the user to store a compiled version of 26303 
his BASIC program. The file is stored on disk 
with the current name and the extension .BAC. 
Or, a new file name can be indicated and the 
extension .BAC will still be appended. 


CONT Allows the user to continue execution of the 2.2.8 
program currently in core following the execu- 
tion of a STOP statement. 


DEASSIGN Used to release the specified device for use 2.6.4 
by others. If no particular device is speci- 
fied, all. devices assigned to that terminal 
are released. An automatic DEASSIGN is per- 
formed when the BYE command is given. 


DELETE Allows the user to remove one or more lines 2.2.5 
from the program currently in core. Following 
the word DELETE the user types the line number 
of the single line to be deleted or two line 
numbers separated by a dash (-) indicating the 
first and last line of the section of code to 
be removed. Several single lines or line 
sections can be indicated by separating the 
line numbers, or line number pairs, with a 
comma. 


HELLO Indicates to RSTS that a user wishes to log 2.1.2 
onto the system. Allows the user to input 
project-programmer number and password. 


KEY Used to re-enable the echo feature on the user 2.6.2 
terminal following the issue of a TAPE command. 
Enter with LINE FEED or ESCAPE key. 


Section in 
RSTS-11 


Command Explanation System User's Guide 


LENGTH Returns the length of the user's current 2.5.1 
program in core, in 1K increments. 


LIST Allows the user to obtain a printed listing 2.2.4 
at the user terminal of the program currently 
in core, or one or more lines of that program. 
The word LIST by itself will cause the list- 
ing of the entire user program. LIST followed 
by one line number will list that line; and 
LIST followed by two line numbers separated 
by a dash (-) will list the lines between and 
including the lines indicated. Several single 
lines or line sections can be indicated by 
separating the line numbers, or line number 
pairs, with a comma. 


LISTNH Same as LIST, but does not print header con- 2.2.4 
taining the program name and current date. 


NEW Clears the user's area in core and allows the 2.2.1 
user to input a new program from the terminal. 
A program name can be indicated following the 
word NEW or when the system requests it. 


OLD Clears the user's area in core and allows the 2.4.2 

user to recall a saved program from a storage 

device. The user can indicate a program name 

following the word OLD or when the system re- 

quests it. If no device name is given, the 

file is assumed to be on the system disk. A 

device specification without a filename will 

cause a program to be read from an input-only 

device (such as high-speed reader, card reader). 


RENAME Causes the name of the program currently in 2.2.6 
core to be changed to the name specified after 
the word RENAME. 


REPLACE Same as SAVE, but allows the user to substitute 2.4.6 
a new program with the same name for an old pro- 
gram, erasing the old program. 


RUN Allows the user to begin execution of the pro- 2.3.1 
gram currently in core. The word RUN can be fol- 
lowed by a file name in which case the file is 
loaded from the system disk, compiled, and run; 
alternatively, the device and file name can be 
indicated if the file is not on the system disk. 
A device specification without a file name will 
cause a program to be read from an input only 
device (such as high-speed reader, card reader). 


RUNNH Same as RUN, but does not print header contain- 2.3.1 
ing the program name and current date. 
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SAVE Causes the program currently in core to be 2.4.1 
saved on the system disk under its current 
file name with the extension .BAS. Where 
the word SAVE is followed by a file name or 
a device and a file name, the program in core 
is saved under the name given and on the de- 
vice specified. A device specification with- 
out a file name will cause the program to be 
output to any output only device (line printer, 
high-speed punch). 


TAPE Used to disable the echo feature on the user 2.6.1 
terminal while reading paper tape via the 
low-speed reader. 


UNSAVE The word UNSAVE is followed by the file name 2.4.5 
and, optionally, the extension of the file to 
be removed. The UNSAVE command cannot remove 
files without an extension. If no extension 
is specified, the source (.BAS) file is deleted. 
If no device is specified, the disk is assumed. 


Special Control Character Summary 


CTRL/C Causes the system to return to BASIC command 34.9 
mode to allow for issuing of further commands 
or editing. Echoes on terminal as ?+C. 


CTRL/O Used as a switch to suppress/enable output of 3.7 
a program on the user terminal. Echoes as tO. 

CTRL/U Deletes the current typed line, echoes as +tU 3.6 
and performs a carriage return/line feed. 

CTRL/Z Used as an end-of-file character. 3.9 

ESCape or Enters a typed line to the system, echoes on 3.2 

ALT MODE the user terminal as a $ character and does 

Key not cause a carriage return/line feed. 

LINE FEED Used to continue the current logical line on 3.3 

Key an additional physical line. Performs a 


carriage return/line feed operation. 


RETURN Enters a typed line to the system, results ina 3.1 

Key carriage return/line feed operation at the user 
terminal. 

RUBOUT Deletes the last character typed on that physi- 3.4 

Key cal line. Erased characters are shown on the 


teleprinter between back slashes. 


TAB or Performs a tabulation to the next of nine tab 3.8 
CTRL/I stops (eight spaces apart) which form the 
terminal printing line. 


APPENDIX C 


ERROR MESSAGE SUMMARY 


Wherever possible, RSTS follows an error message with the phrase 
AT LINE xxxx 


where xxxx is the line number of the statement which caused the error. 


For example: 


1g TALK 
ILLEGAL VERB AT LINE 19 
READY 


The additional message is not printed when no line number can be as- 


sociated with the error. 


TALK 
WHAT? 
READY 


An (SPR) in the description of any error message in this Appendix 
indicates an error which should never be seen by a user. If such a 
message is received, the user should document how he obtained the error 
and file a Software Performance Report with DEC, including the perti- 


nent output. 
C.1 USER RECOVERABLE ERRORS 


A (C) in the description of the error message indicates that pro- 
gram execution continues, following printing of the error message, 
if an ON ERROR GOTO statement is not present. Normally, execution 
terminates on an error condition, the error message is printed, and 
the system prints READY. The ERR column gives the value of the ERR 


variable (see Section 8.4 in the BASIC-PLUS Language Manual). 


ERR Message Printed Meaning 
1 BAD DIRECTORY FOR DEVICE The directory of the device refer- 


enced is an unreadable format or an 
attempt was made to perform a direc- 
tory oriented access to a non- 
directory device. 


Cc-1 


10 


11 


12 


13 


14 


15 


Message Printed 
ILLEGAL FILE NAME 


ACCOUNT OR DEVICE IN USE 


NO ROOM FOR USER ON DEVICE 


CAN'T FIND FILE OR ACCOUNT 


NOT A VALID DEVICE 


I/O CHANNEL ALREADY OPEN 


DEVICE NOT AVAILABLE 


I/O CHANNEL NOT OPEN 


PROTECTION VIOLATION 


END OF FILE ON DEVICE 


FATAL SYSTEM I/O FAILURE 


USER DATA ERROR ON DEVICE 


DEVICE HUNG OR WRITE LOCKED 


KEYBOARD WAIT EXHAUSTED 


Meaning 


The filename specified is not accept- 
able. It contains unacceptable char- 
acters or the filename specification 
format has been violated. 


Removal or dismounting of the account 
or device cannot be done since one 
or more users are currently using it. 


Storage space allowed for the current 
user on the device specified has been 
used or the device as a whole is too 
full to accept further data. 


The file or account number specified 
was not found on the device specified. 


Attempt to use an illegal or nonexis- 
tent device specification. 


An attempt was made to open one of 
the twelve I/O channels which had 
already been opened by the program. 
(SPR) 


The device requested is currently 
reserved by another user. 


Attempt to perform I/O on one of the 
twelve channels which has not been 
previously opened in the program. 


The user was prohibited from perform- 
ing the requested operation because 
the kind of operation was illegal 
(such as input from a line printer) 
or because the user did not have the 
privileges necessary (such as delet- 
ing a protected file). 


Attempt to perform input beyond the 
end of a data file. 


An I/O error has occurred on the sys- 
tem level. The user has no guarantee 
that the last operation has been 
performed. (SPR) 


One or more characters may have been 
transmitted incorrectly due to a par- 
ity error, bad punch combination on 

a card, or similar error. 


User should check hardware condition 
of device requested. Possible causes 
of this error include a line printer 
out of paper or high-speed reader 
being off-line. 


Time requested by WAIT statement has 
been exhausted with no input received 
from the specified keyboard. 
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ERR 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 
30-41 


42 


43 


Message Printed 
NAME OR ACCOUNT NOW EXISTS 


TOO MANY OPEN FILES ON UNIT 


ILLEGAL SY¥S() USAGE 


DISK BLOCK IS INTERLOCKED 


PACK IDS DON'T MATCH 


DISK PACK IS NOT MOUNTED 
DISK PACK IS LOCKED OUT 
ILLEGAL CLUSTER SIZE 


DISK PACK IS PRIVATE 


DISK PACK NEEDS 'CLEANING' 
FATAL DISK PACK MOUNT ERROR 


I/O TO DETACHED KEYBOARD 


PROGRAMMABLE +C TRAP 


CORRUPTED FILE STRUCTURE 
not assigned 


VIRTUAL BUFFER TOO LARGE 


VIRTUAL ARRAY NOT ON DISK 


Meaning 


An attempt was made to rename a 
file with the name of a file which 
already exists, or an attempt was 
made by the system manager to in- 
sert an account number which is 
already within the system, 


Only one open DECtape output file 
is permitted per DECtape drive. 
Only one open file per magtape 
drive is permitted. 


Illegal use of the SYS system func- 
tion. 


The requested disk block segment 
is already in use (locked) by some 
other user. 


The identification code for the 
specified disk pack does not match 
the identification code already on 
the pack. 


No disk pack is mounted on the 
specified disk drive. 


The disk pack specified is mounted 
but temporarily disabled. 


The specified cluster size is unac- 
ceptable. 


The current user does not have ac- 
cess to the specified private disk 
pack. 


Non-fatal disk mounting error; use 
the CLEAN operation in UTILTy, 

Fatal disk mounting error. Disk can- 
not be successfully mounted. 


I/O was attempted to a hung up 
dataset or to the previous, but now 
detached, console keyboard for the 
job. 


ON ERROR-GOTO subroutine was entered 
through a program trapped CTRL/C. 
See a description of the SYS system 
function. 


Fatal error in CLEAN operation. 


Virtual core buffers must be 512 
bytes long. 


A non-disk device is open on the 
channel upon which the virtual ar- 
ray is referenced. 


C-3 


46 


47 


48 


49 


50 


Sl 


52 


53 


54 


55 


56 


57 


58 


Message Printed 
MATRIX OR ARRAY TOO BIG 


VIRTUAL ARRAY NOT YET OPEN 


ILLEGAL 1/0 CHANNEL 


LINE TOO LONG 


FLOATING POINT ERROR 


ARGUMENT TOO LARGE IN EXP 


not assigned 


INTEGER ERROR 


ILLEGAL NUMBER 


ILLEGAL ARGUMENT IN LOG 


IMAGINARY SQUARE ROOTS 


SUBSCRIPT OUT OF RANGE 


CAN'T INVERT MATRIX 


OUT OF DATA 


ON STATEMENT OUT OF RANGE 


Meaning 
In-core array size is too large. 


An attempt was made to use a virtual 
array before opening the correspond- 
ing disk file. 


Attempt was made to open a file on 
an I/O channel outside the range of 
the integer numbers 1 to 12. 


Attempt to input a line longer than 
255 characters (which includes any 
line terminator). Buffer overflows. 


Floating point overflow or under- 
flow. If no transfer is made to 
an error handling routine, a g is 
returned as the floating point 
value, (C) 


Acceptable arguments are within the 
approximate range -89<arg<+88. The 
value returned is zero. (C) 


Attempt to use a number as an in- 
teger when that number is outside 
the allowable integer range. If 
no transfer is made to an error 
handling routine, a @ is returned 
as the integer value. (C) 


Improperly formed input or value. 
For example, "1..2" is an improp- 
erly formed number. 


Negative or zero argument to log 
function. Value returned is the 
argument as passed to the function. 
(C) 


Attempt to take square root of a 

number less than zero. The value 
returned is the square root of the 
absolute value of the argument. (C) 


Attempt to reference an array ele- 
ment beyond the number of elements 
created for the array when it was 
dimensioned. 


Attempt to invert a singular or 
nearly singular matrix. 


The DATA list was exhausted and a 
READ requested additional data. 


The index value in an ON-GOTO or 
ON-GOSUB statement is less than one 
or greater than the number of line 
numbers in the list. 


C-4 


ERR Message Printed 

59 NOT ENOUGH DATA IN RECORD 
60 INTEGER OVERFLOW, FOR LOOP 
61 DIVISION BY @ 

C.2 NON-RECOVERABLE ERRORS 


Message Printed 
ARGUMENTS DON'T MATCH 


BAD LINE NUMBER PAIR 


BAD NUMBER IN 


PRINT-USING 


CAN'T COMPILE STATEMENT 


CAN'T CONTINUE 


CATASTROPHIC ERROR 


DATA TYPE ERROR 


DEF WITHOUT FNEND 


END OF STATEMENT NOT SEEN 


EXECUTE ONLY FILE 


Meaning 


An INPUT statement did not find 
enough data in one line to satisfy 
all the specified variables. 


The integer index in a FOR loop 
attempted to go beyond 32766 or 
below -32766. 


Attempt by the user program to 
divide some quantity by zero. 
no transfer is made to an error 
handler routine, a @ is returned 
as the result. (C) 


If 


Meaning 


Arguments in a function call do not 
match, in number or in type, the 
arguments defined for the function. 


Line numbers specified in a LIST or 
DELETE command were formatted incor- 
rectly. 


Format specified in the PRINT-USING 
string cannot be used to print one 
or more values. 


Program was stopped or ended ata 
spot from which execution cannot be 
resumed. 


The user program data structures are 
destroyed. This normally indicates 

a BASIC-PLUS malfunction and, if re- 
producible, should be reported to DEC 
on a Software Performance Report form. 
(SPR) 


Incorrect usage of floating-point, 
integer, or character string format 
variable or constant where some other 
data type was necessary. 


A second DEF statement was encoun- 
tered in the processing of a user 
function without an FNEND statement 
terminating the first user function 
definition. 


Statement contains too many elements 
to be processed correctly. 


Attempt was made to add, delete or 


list a statement in a compiled (.BAC) 
format file. 


C-5 


Message Printed 


EXPRESSION TOO COMPLICATED 


FIELD OVERFLOWS BUFFER 


FILE EXISTS-USE REPLACE 


FNEND WITHOUT DEF 


FNEND WITHOUT FUNCTION CALL 


FOR WITHOUT NEXT 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


CONDITIONAL CLAUSE 


DEF NESTING 


DUMMY VARIABLE 


EXPRESSION 


FIELD VARIABLE 


FN REDEFINITION 


FUNCTION NAME 


Meaning 


This error usually occurs when 
parentheses have been nested too 
deeply. The depth allowable is 
dependent on the individual expres- 
sion. 


Attempt to use FIELD to allocate 
more space than exists in the speci- 
fied buffer. 


A file of the name specified in a 
SAVE command already exists. In 

order to save the current program 
under the name specified, use the 
REPLACE command. 


An FNEND statement was encountered 
in the user program without a pre- 
vious DEF statement being seen. 


A FNEND statement was encountered 
in the user program without a pre- 
vious function call having been 
executed. Function has been placed 
incorrectly among executable state- 
ments or an extra FNEND statement 
has been found. 


A FOR statement was encountered in 
the user program without a corre- 
sponding NEXT statement to terminate 
the loop. 


Incorrectly formatted condition ex- 
pression. 


The range of one function definition 
crosses the range of another func- 
tion definition. 


One of the variables in the dummy 
variable list of a user-defined 
function is not a legal variable 
name. 


Double operators, missing operators, 
mismatched parentheses, or some 
similar error has been found in an 
expression. 


The FIELD variable specified is un- 
acceptable. 


Attempt was made to redefine a user 
function. 


Attempt was made to define a func- 
tion with a function name not sub- 
scribing to the established format. 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


INCONSISTENT FUNCTION USAGE 


INCONSISTENT SUBSCRIPT USE 


Message Printed 
IF STATEMENT 


IN IMMEDIATE MODE 


LINE NUMBER(S) 


MAGTAPE() USAGE 


MODE MIXING 


STATEMENT 


SYMBOL 


VERB 


K OF CORE USED 


LITERAL 


STRING NEEDED 


MATRIX DIMENSION ERROR 


MATRIX OR ARRAY WITHOUT DIM 


MAXIMUM CORE EXCEEDED 


MISSING 


SPECIAL FEATURE 


Meaning 


Incorrectly formatted IF statement. 


User issued a statement for execu- 
tion in immediate mode which can 
only be performed as part of a pro- 
gram. 


Line number reference outside the 
range 1<n<32767, 


Improper use of the MAGTAPE function. 


String and numeric operations cannot 
be mixed. 


Attempt was made to execute a state- 
ment that did not compile without 
errors. 


An unrecognizable character was en- 
countered. For example, a line con- 
sisting of a # character. 


The BASIC verb portion of the state- 
Ment cannot be recognized. 


A function is being redefined in a 
Manner inconsistent in the number or 
type of arguments with one or more 
calls to that function existing in 
the program. 


A subscripted variable is being used 
with a different number of dimensions 
from the number with which it was 
originally defined. 


Message printed by LENGTH command, 
preceded by the appropriate number 
describing the user program currently 
in core to the nearest 1K. 


A variable name was used where a 
numeric or character string was 
necessary. 


Attempt was made to dimension a 
matrix to more than two dimensions, 
Or an error was made in the syntax 
of a DIM statement. 


A matrix or array element was ref- 
erenced beyond the range of an 
implicitly dimensioned matrix. 


User program grew to be too large 
to run or compile in the area of 
core assigned to each user at the 
given installation. 


User program employs a BASIC-PLUS 
feature not present on the given 
installation. 
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Message Printed 


MODIFIER ERROR 


NEXT WITHOUT FOR 


NO LOGINS 


NOT A RANDOM ACCESS DEVICE 


NOT ENOUGH AVAILABLE CORE 


NUMBER IS NEEDED 
1 OR 2 DIMENSIONS ONLY 
ON STATEMENT NEEDS GOTO 


PLEASE SAY HELLO 


PLEASE USE THE RUN COMMAND 


PRINT-USING BUFFER OVERFLOW 


PRINT-USING FORMAT ERROR 


PROGRAM LOST-SORRY 


REDIMENSIONED ARRAY 


RESUME AND NO ERROR 


Meaning 


Attempt to use one of the statement 
modifiers (FOR, WHILE, UNTIL, IF, 
or UNLESS) incorrectly. 


A NEXT statement was encountered in 
the user program without a previous 
FOR statement having been seen. 


Message printed if the system is 
full and cannot accept additional 
users or if further logins are dis- 
abled by the system manager. 


Attempt to perform random access I/O 
to a non-random access device. 


The already compiled user program is 
too large to run in the area of core 
assigned to each user at the given 
installation. 


A character string or variable name 
was used where a number was necessary. 


Attempt was made to dimension a matrix 
to more than two dimensions. 


A statement beginning with ON does 
not contain a GOTO or GOSUB clause. 


User not logged into the system has 
typed something other than a legal, 
logged-out command to the system. 


A transfer of control (as in a GOTO, 
GOSUB or IF-GOTO statement) cannot 
be performed from immediate mode. 


Format specified contains a field too 
large to be manipulated by the PRINT- 
USING statement. 


An error was made in the construction 
of the string used to supply the out- 
put format in a PRINT-USING statement. 


A fatal system error has occurred 
which caused the user program to be 
lost. 


Usage of an array or matrix within 
the user program has caused BASIC- 
PLUS to redimension the array im- 
plicitly. 


A RESUME statement was encountered 
where no error had occurred to cause 
a transfer into an error handling 
routine via the ON ERROR-GOTO state- 
ment. 
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Message Printed 


RETURN WITHOUT GOSUB 


STATEMENT NOT FOUND 


STOP 


STRING IS NEEDED 


SYNTAX ERROR 


TEXT TRUNCATED 


TOO FEW ARGUMENTS 


TOO MANY ARGUMENTS 


UNDEFINED FUNCTION CALLED 


WHAT? 


WRONG MATH PACKAGE 


C.3 SYSTEM IDENTIFICATION MESSAGE 


Meaning 


RETURN statement encountered in the 
user program without a previous 
GOSUB statement having been executed. 


Reference is made within the program 
to a line number which is not within 
the program. 


STOP statement was executed. The 
user can usually continue program 
execution by typing CONT and the 
RETURN key. 


A number or variable name was used 
where a character string was neces- 
sary. 


BASIC-PLUS statement was incorrectly 
formatted. 


No BASIC-PLUS statement can be more 
than 255 characters long. 


The function has been called with 
a number of arguments not equal to 
the number defined for the function. 


A user-defined function may have up 
to five arguments. 


BASIC-PLUS interpreted some state- 
ment component as a function call 
for which there is no defined func- 
tion (system or user). 


Command or immediate mode statement 
entered to BASIC-PLUS could not be 
processed. Illegal verb or improper 
format error most likely. 


Program was compiled with an incom- 
patible version of RSTS. Program 
source must be recompiled. 


ERR code @ is associated with the system installation name 


for use by the system programs. 


APPENDIX D 
BASIC-PLUS CHARACTER SET 


D.1 BASIC-PLUS CHARACTER SET 
User program statements are composed of individual characters. 


Allowable characters come from the following character set: 


A through 2 
g through 9 
Space 
Tab 
and the following special symbols and keys: 


Key Use and Section in BASIC-PLUS Language Manual 
$ Used in specifying string variables (Section 5.1), 


Or as the System Library file designator (RSTS-11 
System User's Guide). 


% Used in specifying integer variables (Section 6.1). 


ae Used to delimit string constants, i.e., text 
strings (Section 5.1). 


! Begins comment part of a line (Section 3.1). 


Separates multiple statements on one line 
(Section 2.3.1). 


# Denotes a device or file # name, or is used as an 
output format effector (Chapter 7 and Section 10.4). 


; Output format effector and list terminator 
(Section 3.3). 


: Output format effector (Section 3.3). 


LINE When used at the end of a line, indicates that 
FEED the current statement is continued on the next 
tine (Section 2.3.2). 


() Used to group arguments in an arithmetic ex- 
pression (Section 2.5). 

{ J Used to group project-programmer number. 

<> Used to delimit file protection codes. 


Arithmetic operators (Section 2.5.3). 


= Replacement operator (Section 3.2). 
Logical equivalence operator (Section 2.5.4). 


< Logical "less than" operator (Section 2.5.4). 
> Logical "greater than" operator (Section 2.5.4). 


Logical "approximately equal to" operator (Section 2.5.4) 


D-1 


D.2 ASCII CHARACTER CODES 


ASCII RSTS Decimal ASCII 
Character Usage Value Character 


# 


Backslash Vertical Line 


@ 
A 
B 
Cc 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
T 
U 
Vv 
W 
x 
Y 
Z 
[ 
‘N 


re —-ANK ME PGetURQUUTOSB SPV TQ MOAA DM 


Tilde 
RUBOUT 


0.3 CARD CODES 


The RSTS card driver can be configured for one of three different 
punched card codes. These are: DEC#29 codes, DEC#26 codes and 1491 
(EBCDIC) codes. The RSTS-11 DEC#29 and DEC#26 codes are the same as 
the DOS-11 card codes. The particular set of codes used on the system 
is determined by the system manager. In all cases, the end-of-file 
(EOF) card must contain a 12-11-g-1 punch or a 12-11-9-1-6-7-8-9 punch 


in column @. 


CHARACTER ASCII, , DECA29 DECO26 1491 | CHARACTER ASCIT,,  DECO29 DECO26 1401 


UNUSED 


ioe) 
n= 
00 
ney 
Heb oo 
Nb bh 
fay 


ae 
NNN NLH 
| 
N 


| all onl ae 
NNN to 


= 
N 


i odin 
NNN) 


+ FH Hh OTH HE 
PRE PEE 
HPNNNNN 


I~ 


OMINHDMNEPWNPWODND UW BW wtOE 
OMDANDUBWNHEUODANHDMNaAWhH HY 


1 
2 
3 
4 
5 
6 
7 
8 
9 
ll i 
11 2 
3 
4 
5 
6 
7 
8 
9 


VDIDUNARWNHRPBAN 
tH FONK KM ESC CHANDONOZ EYP RAUHTOAMUAW Pe 
Cm Hn awh 
CON HU PWN 
CDNHU AW 


REPRE RRBWRAAQARW 
DOH OF MNMNAQRNRRR 


Nw 


OV Il A se oe 


EOF is 12-11-9-1 punch or a 12~-11-§-1-6-7-8-9 punch. 


D.4 RADIX-58 CHARACTER SET 


Radix-59 
Character ASCII Octal Equivalent Equivalent 
space 4g g 
A-Z 191 - 132 1 - 32 
$ 44 33 
- 56 34 
unused 35 
g-9 68 - 71 36 - 47 


The maximum Radix-5@ value is, thus, 
47*597 + 47*59 + 47 = 174777 


The following table provides a convenient means of translating 
between the ASCII character set and its Radix-5ff equivalents. For 
example, given the ASCII string X2B, the Radix-5f equivalent is 


(arithmetic is performed in octal): 


X = 113999 
2 = 92499 
B= J99992 
X2B = 11542 


Radix-5@ Character/Position Table 


Single Char. 
or Second Third 
First Char. Character Character 


G93198 
666266 
611366 
614406 
617568 
622666 
625766 
631066 
634166 
637266 
642366 
£45466 
650566 
253686 
056768 
$62606 
6651668 
76266 
073366 
£76466 
16156 
14682 
187788 
11368¢ 
116182 
1212¢¢ 
12439¢ 
1274868 ‘ ‘s 
132588 unused unused 
135688 
148786 
14494¢ 
14718¢ 
152268 
1553668 
166488 
163582 
166688 
1717608 


BLBISH GPOGS1 


266662 


A 
B 
Cc 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
T 
U 
Vv 
W 
Xx 
Y 
Z 
$ 


UNKXESICHNDONOSZERZYPAQHMOADMUOW Y 
NK KX ESGCCHAHNWOVOSZEHYAUHTMADAHMONWY 


WOADNINAUOPWHEHQ 
WODWNHANPWNHHD 
WDMDNIKHUMNPWNHEeHQ 


683630 OO6647 


INDEX 


Account numbers, 2-1 HELLO, 2-1, 2-6, 4-2 

ALT MODE key, 3-1 HELP, 2-6, 4-2 

ASR~33 terminal, 3-1 High-speed reader/punch, 5-4 
ASSIGN, 2-25 

Assigned devices, 1-4 Input of new programs, 2-7 


Interactive programs, 1-2 
.BAC and .BAS, see File extensions 


BYE, 2-3, 2-26, 4-5 KEY, 2-24, 3-1 
Card reader, 2-14, 5-6 LENGTH, 2-22 
CAT, 2-22, 4-16 LINE FEED key, 3-1 
CATALOG, 2-22, 4-16 Line printer, 5-7 
CHAIN, 2-15 LIST, 2-17, 2-7, 2-9 
Change filename, 4-13 List device directory, 4-16 
Change protection code, 4-13 LISTNH, 2-10 
Character set, D-1 Logged out system commands, 2-5 
COMPILE, 2-6, 2-15 LOGIN, 2-1, 4-2 
CONT, 2-12 LOGOUT, 4-5 
CTRL/C, 2-12, 3-2, 3-3 
CTRL/I, 3-3 Magtape, 5-14 
CTRL/O, 3-3 Modem, 1-5 
CTRL/U, 2-8, 3-2 MONEY, 4-25 
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